Testes Next.js
Prioridade: P1 (ALTA)
Estrutura
tests/
├── unit/ # Vitest + RTL
├── e2e/ # Playwright
└── mocks/ # Handlers MSW
Diretrizes de Implementação
- Testes Unitários: Use Vitest para velocidade e React Testing Library (RTL) para comportamento dos componentes. Siga os padrões Arrange-Act-Assert (AAA).
- Testes E2E: Use Playwright para validação completa do App Router. Foco em Fluxos de Usuário (ex.: Login, Checkout).
- Rede: Simule todos os limites de API internos/externos usando Mock Service Worker (MSW). Garanta que os handlers
server e browser estejam configurados corretamente.
- Testes de RSC: Teste os React Server Components (RSC) usando os mesmos padrões das bibliotecas (testes compatíveis com SSR). Prefira testes E2E para lógica complexa de busca assíncrona de dados.
- Interações: Use
userEvent (assíncrono) para simular ações do usuário: await user.click(button).
- Seletores: Prefira
getByRole / findByRole para testar acessibilidade. Use data-testid apenas como fallback.
- Ambiente: Configure o
vitest.config.ts com jsdom ou happy-dom para testes de componentes.
- Relatórios: Garanta que os testes gerem relatórios de cobertura JSON para gates de CI. Busque 80%+ de cobertura nas bibliotecas principais.
Anti-Padrões
- Nenhum uso real de rede nos testes: Sempre use handlers MSW ou mocks.
- Nenhum teste de implementação: Teste o comportamento do usuário, não métodos internos.
- Nenhum E2E pesado para lógica unitária: Use Vitest para testes de lógica isolada.
- Nenhum vazamento de estado global: Reinicie os handlers e mocks do MSW após cada teste.
Referências