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

O que cada nível prova e quanto custa
NívelProva queVelocidadeFerramentas comuns
UnidadeA lógica de uma parte está corretaMilissegundosVitest, Jest, JUnit, pytest
IntegraçãoAs partes conversam do jeito combinadoSegundosTesting Library, Supertest, Testcontainers
Ponta a pontaA pessoa consegue concluir a tarefaSegundos a minutosPlaywright, 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.

Referências

Trilhas relacionadas