Pular para o conteúdo

test-e2e

test-e2e é a orientação pra testes end-to-end com Playwright — o app montado, num browser real, exercitando os fluxos que de fato importam. É o topo da pirâmide de testes: poucos testes, alto valor, e os mais propensos a flakiness se você os escreve errado.

O que resolve

Testes E2E são onde os times ou ganham confiança de verdade ou uma suíte flaky que todo mundo aprende a ignorar. Os dois jeitos de dar errado são conhecidos: flakiness por competir com a UI usando waits fixos, e inmanutenibilidade por seletores e setup copiados em cada spec. Uma suíte vermelha sem motivo é pior que suíte nenhuma — treina as pessoas a re-rodar até ficar verde.

Como resolve

A skill codifica os padrões que mantêm uma suíte E2E confiável:

  • Page Object Model — seletores e interações vivem num lugar por tela, então uma mudança de UI toca um arquivo, não cinquenta specs.
  • Confiabilidade — locators com auto-wait e esperas explícitas por rede, com regra dura de “nada de waitForTimeout fixo”; você espera uma condição, nunca uma duração chutada.
  • Isolamento — cada teste monta o próprio estado e limpa, então ordem nunca importa e uma falha aponta pra uma causa.
  • Escopo — E2E cobre as jornadas críticas e preocupações transversais (auth, pagamentos, o happy path de cada fluxo), mais checks de acessibilidade — não o que um teste de componente rápido já cobre.

Quando usar

Montando E2E num projeto, ou adicionando cobertura pra um fluxo crítico que só um browser real contra um backend real valida. Pra um único componente ou hook isolado, use test-component — e não re-teste em E2E o que aquela camada já cobre.