Que teste escrever?
Unidade, integração e ponta a ponta: o que cada um prova, quanto custa e como equilibrar a suíte.
8 min de leitura · Iniciante · Revisado em
A pergunta certa
Não existe "o melhor teste". Existe o teste que dá mais confiança pelo menor custo para aquele risco. Testes mais realistas pegam mais problemas, mas são mais lentos, mais caros de manter e mais difíceis de diagnosticar quando falham.
A pirâmide de testes: muitos testes rápidos na base e poucos testes realistas no topo.
- Ponta a ponta: Um navegador ou cliente real percorre o fluxo inteiro, com banco e serviços. Poucos, nos caminhos críticos: login, compra, cadastro.
- Integração: Peças reais juntas: API com banco, componente com roteador. Pegam erros de contrato, consulta e configuração.
- Unidade: Uma função ou classe isolada, em milissegundos. Cobrem regras de negócio e casos de borda.
Os três níveis lado a lado
| Nível | Prova que | Velocidade | Ferramentas comuns |
|---|---|---|---|
| Unidade | A lógica de uma parte está correta | Milissegundos | Vitest, Jest, JUnit, pytest |
| Integração | As partes conversam do jeito combinado | Segundos | Testing Library, Supertest, Testcontainers |
| Ponta a ponta | A pessoa consegue concluir a tarefa | Segundos a minutos | Playwright, Cypress |
Como um bom teste se parece
Unidade: organize, aja e confira
import { describe, it, expect } from 'vitest';
import { aplicarDesconto } from './preco';
describe('aplicarDesconto', () => {
it('não deixa o preço ficar negativo', () => {
const preco = 30; // organize
const resultado = aplicarDesconto(preco, 50); // aja
expect(resultado).toBe(0); // confira
});
});Integração no frontend: interaja como a pessoa usuária
render(<Busca />);
await userEvent.type(
screen.getByRole('searchbox', { name: 'Buscar curso' }),
'react',
);
expect(await screen.findByText('3 cursos encontrados')).toBeInTheDocument();Repare que o segundo teste procura elementos pelo papel e pelo nome, como um leitor de tela faria. Se ele não encontra o campo, provavelmente a interface também tem um problema de acessibilidade.
Antes de abrir o pull request
- O teste falha se eu desfizer a correção. Confirmei isso de propósito.
- Testa o comportamento, não detalhes internos. Uma refatoração não deveria quebrá-lo.
- O nome descreve a regra: "não deixa o preço ficar negativo", não "teste 3".
- Cobre casos de borda: lista vazia, limite exato, entrada inválida, erro da API.
- Não depende da ordem dos testes, do horário nem de serviços externos reais.
- Quando falha, a mensagem mostra o que era esperado e o que veio.