Teste de caixa preta olha apenas entradas e saídas e ignora como o código foi escrito. Teste de caixa branca lê o código e seus ramos. Teste de caixa cinza fica no meio: quem testa conhece parte da informação interna — APIs, logs, estruturas de dados, eventos de analytics — sem ler a implementação linha a linha. Os três testam a mesma funcionalidade; o que muda é quanta informação interna você tem e, portanto, quais perguntas consegue fazer.
Escolher errado custa caro. Procurar em caixa preta um problema que só a caixa cinza enxerga — um tipo de campo que mudou, por exemplo — não aparece nem depois de cem rodadas. Na direção oposta, exigir que testadores de negócio leiam código transforma teste em atividade paralela de quem desenvolve.
As três caixas comparadas
| Dimensão |
Caixa preta |
Caixa cinza |
Caixa branca |
| Conhecimento interno |
Quase nenhum: requisitos e interface |
APIs, logs, estruturas de dados, parte da implementação |
Código e estrutura completos |
| O que verifica |
Se o comportamento atende ao esperado |
Comportamento mais consistência interna |
Ramos, limites, cobertura |
| Quem faz |
Testadores de negócio, produto, customer success |
Testadores que conhecem a API, desenvolvimento |
Desenvolvimento |
| Técnicas típicas |
Classes de equivalência, valores limite, tabelas de decisão, transição de estados, pairwise |
Verificação de API, conferência de logs, validação de analytics, testes de contrato |
Testes unitários, cobertura, análise estática |
| Custo |
O mais baixo, começa na hora |
Médio, exige ambiente e documentação |
O mais alto, requer ler código |
| O que escapa |
Problemas que só aparecem com dados ou ambientes específicos |
Problemas de sincronização entre sistemas |
Problemas que o usuário não percebe |
Um fato pouco lembrado: o que um time web faz no dia a dia é, em sua maioria, caixa cinza; só não se chama assim. Abrir o painel Rede para ler um código de status ou o console para ler um erro já é usar informação interna.
As cinco técnicas de caixa preta
Com um formulário de login como exemplo:
Classes de equivalência: dividir as entradas em "telefone válido / formato inválido / vazio" e pegar um representante de cada.
Valores limite: senha de 8 a 20 caracteres significa testar 7, 8, 20 e 21.
Tabelas de decisão: combinar "conta existe × senha correta × conta bloqueada" e verificar cada linha.
Transição de estados: não verificada → verificada → bloqueada, conferindo cada caminho e cada salto ilegal.
Pairwise: navegador × sistema × idioma × papel, em pares, cobrindo mais combinações com menos casos.
Nenhuma precisa de informação interna e, juntas, transformam "clicar por aí" em um conjunto de casos reutilizável. Como escrevê-los está em Modelos de casos de teste com exemplos.
Caixa cinza em um time web, na prática
Não é preciso ler código. As ferramentas do navegador bastam:
- Requisições: confirmar no painel Rede que a API devolve 200 com um campo alterado, ou já 4xx / 5xx;
- Erros: o texto vermelho do console costuma estar mais perto da causa do que o sintoma na tela;
- Contratos: a documentação diz
price: number, a resposta traz "12.00"; só a caixa cinza vê isso;
- Analytics: um evento que nunca dispara é invisível na interface, mas corrompe decisões.
O que os quatro têm em comum: nenhum é um "sintoma visível", e todos decidem se o bug será corrigido e por quem.
Por que os relatos de caixa preta voltam
Por falta de evidência. O mesmo caso, duas versões:
| Versão |
O que o desenvolvedor faz |
| "O login não faz nada" |
Pergunta qual conta, qual navegador e se o console mostra algo |
"Chrome 141 / Windows 11, a conta de teste A digita a senha correta em https://example.com/login e a página não navega; Rede mostra POST /api/login com 500, console mostra Unhandled promise rejection" |
Vai direto aos logs do servidor |
A diferença não é de redação: é se os três fatos de caixa cinza vieram junto — ambiente, requisição com falha, texto do erro.
Existe uma tensão real aqui: testadores de caixa preta — negócio, suporte, clientes — não deveriam ser obrigados a ler o console. A resposta não é treinamento, é captura automática: instalar uma extensão do navegador ou embutir um ponto de entrada de feedback no site, e deixar a ferramenta levar erros de console, requisições com falha, navegador e viewport. É exatamente a camada que o BugCapturer oferece: quem testa continua em caixa preta, o relato chega com detalhe de caixa cinza.
Quando a caixa preta basta e quando a cinza é obrigatória
| Situação |
Recomendação |
Por quê |
| Aceite de uma funcionalidade nova |
Caixa preta |
Verifica-se comportamento, não implementação |
| Regressão antes de publicar |
Caixa preta mais caixa cinza nas rotas críticas |
Fluxo por comportamento; login e pagamento pela requisição |
| Mudança de campos de API, integração |
Caixa cinza |
A interface pode parecer certa com os dados já errados |
| Desempenho e timeouts |
Caixa cinza |
São necessárias durações e taxa de falha das requisições |
| Segurança e permissões |
Principalmente caixa cinza |
Escalada de privilégio costuma ser invisível na interface |
| Páginas estáticas, textos |
Caixa preta |
Não há cadeia interna para inspecionar |
A caixa branca não aparece na tabela porque raramente é trabalho de quem testa: testes unitários, cobertura e análise estática pertencem à autoverificação do desenvolvimento e correm em outra trilha.
Um exemplo: callback de pagamento em três lentes
O mesmo sintoma, três profundidades de resposta.
- Caixa preta vê: o cliente paga, o pedido continua "pendente". O comportamento não bate; abre-se um bug.
- Caixa cinza vê: o painel Rede mostra
POST /api/pay/callback com 200, mas o corpo traz status: "pending"; o console está limpo. O problema está no tratamento de estado no servidor, não no front.
- Caixa branca vê: o handler grava um log e depois atualiza o pedido; a falha da atualização é engolida por um
catch vazio. É defeito de lógica, e provavelmente não o único.
Conclusão prática: um relato que chega ao segundo nível permite começar na hora; um preso no primeiro custa três rodadas de perguntas. Chegar ao nível dois não exige ler código, só anexar aquela requisição.
Colocando as caixas no plano de testes
| Etapa |
Caixa principal |
Entregável |
| Após a revisão de requisitos |
Caixa preta |
Desenho de casos e critérios de aceite |
| Integração, primeira build |
Caixa cinza |
Conferência de contrato, inventário de campos e códigos de erro |
| Regressão antes de publicar |
Caixa preta mais caixa cinza nas rotas críticas |
Checklist de regressão, capturas das requisições críticas |
| Depois de publicar |
Caixa cinza (logs e monitoramento) mais caixa preta (feedback real) |
Regras de alerta, relatos de usuários |
O ponto é o divisão de responsabilidade: a caixa preta responde "está certo?", a cinza "por que está errado?", a branca "o código é arriscado?".
Três pré-requisitos para a caixa cinza
Caixa cinza não se decreta. Falta um destes três e ela volta a ser caixa preta:
Acesso ao ambiente: ambiente de teste acessível e conta com permissão, senão a requisição nem sai.
Visibilidade de logs e requisições: no mínimo as ferramentas do navegador, idealmente logs do servidor.
Conhecimento do contrato: campos, códigos de erro e valores obrigatórios documentados, ou alguém para responder.
O terceiro é o que mais falta. Sem contrato, dá para julgar "a página está certa", mas não "os dados estão certos" — e é assim que problemas de campo chegam à produção.
Três equívocos
- Caixa branca é teste unitário: é o uso mais típico, mas também inclui revisão de código, análise de cobertura e varredura estática.
- Caixa cinza é ler código: o núcleo é conhecer informação interna. Ler logs e requisições conta; ler a implementação não.
- Automação é caixa branca: automação de interface costuma ser caixa preta (só opera a tela), automação de API fica mais perto da cinza. Técnica e caixa são eixos diferentes.
FAQ
Caixa preta exige conhecimento técnico?
Não de código, mas exige descrever sintomas com precisão, preparar dados e julgar se algo é comportamento esperado. O resto da evidência pode vir de uma ferramenta.
Caixa cinza precisa de documentação de API?
Ajuda, mas não é obrigatória: abrir o painel Rede e ler requisições e respostas reais já é caixa cinza.
Um time pequeno pode fazer só caixa preta?
Sim, com dois acréscimos: conferir as requisições das rotas críticas antes de publicar e fazer os relatos levarem erros de console e requisições com falha automaticamente. Ambos custam muito menos que uma pessoa dedicada.
As três caixas são excludentes?
Não. Caixa preta no aceite, cinza na integração e branca na autoverificação é uma combinação comum na mesma funcionalidade.
Como saber se um relato é "caixa cinza o suficiente"?
Perguntando se o desenvolvedor consegue começar sem perguntar nada: ambiente, requisição com falha, texto do erro. Se os três estão lá, é.