Melhores Práticas de Playwright: 10 Regras que Agentes de IA Erram

Agentes de IA podem escrever 50 testes de Playwright em um minuto.

Essa velocidade é uma armadilha.

Esses testes frequentemente falham sem motivo. Agentes de IA copiam padrões antigos de dados de treinamento. Eles não sabem que seus testes falharam ontem à noite. Eles usam hábitos obsoletos.

Siga estas 10 regras para manter seus testes estáveis.

  1. Use locators baseados em roles Use getByRole, getByLabel ou getByText. Eles correspondem ao que uma pessoa vê. Erro de IA: Agentes usam CSS ou XPath. Eles quebram quando você altera um único nome de classe.

  2. Use asserções web-first Use expect(locator).toBeVisible(). Isso aguarda a página automaticamente. Erro de IA: Agentes adicionam await page.waitForTimeout(3000). Esperas fixas (hard waits) causam testes instáveis (flaky).

  3. Mantenha os testes isolados Cada teste deve começar do zero. Use hooks para configurar o estado. Erro de IA: Agentes encadeiam testes. Se o primeiro teste falhar, o arquivo inteiro quebra.

  4. Popule dados (seed data) via API Use a fixture request para enviar dados diretamente para o seu backend. Erro de IA: Agentes clicam por dez telas de UI para criar um único usuário. Isso torna os testes lentos e frágeis.

  5. Priorize roles em vez de test IDs Use getByRole primeiro. Use data-testid apenas como fallback. Erro de IA: Agentes colam data-testid em tudo. Isso ignora bugs onde um botão não possui um rótulo para leitores de tela.

  6. Configure traces para gravar em caso de retry Defina trace como 'on-first-retry' em sua configuração. Erro de IA: Agentes deixam o rastreamento desligado ou ligado para cada execução. Um carece de evidências, o outro deixa tudo mais lento.

  7. Execute em paralelo Use o modo paralelo e sharding para dividir os testes entre máquinas. Erro de IA: Agentes escrevem testes que compartilham um único usuário. Esses testes conflitam entre si em paralelo.

  8. Remova instruções if e blocos try Um teste deve seguir apenas um caminho. Se um botão deve estar lá, faça uma asserção. Erro de IA: Agentes envolvem cliques em instruções if para evitar erros. Isso esconde bugs reais.

  9. Teste o comportamento, não os detalhes internos Verifique o resultado visível na tela. Erro de IA: Agentes fazem asserções em classes CSS ou variáveis de estado. Elas quebram a cada refatoração de código.

  10. Use projetos para cobertura de navegadores Use o array projects para testar Chromium, Firefox e WebKit. Erro de IA: Agentes fixam (hard-code) um único navegador. Você perde bugs que só acontecem no Safari.

A IA escreve um primeiro rascunho rápido. Ela carece de sabedoria.

Uma suíte de testes "verde" que não prova nada é perigosa. Ela cria uma falsa sensação de confiança.

Deixe a IA escrever o rascunho. Use um humano para aplicar estas regras. O agente proporciona velocidade. O humano proporciona estabilidade.

Fonte: https://dev.to/aiwithanton/playwright-best-practices-10-rules-ai-agents-get-wrong-2026-5cii

Comunidade de aprendizado opcional: https://t.me/GyaanSetuAi