Neste artigo
- Agente IA testar navegador Playwright: 5 passos para o agente checar o próprio trabalho no browser
- Por que só teste não basta
- Passo 1: dê um navegador de verdade ao agente
- Passo 2: faça o teste de sanidade no TodoMVC
- Passo 3: escreva as regras do que conta como prova
- Passo 4: suba o app do jeito que o projeto já sobe
- Passo 5: revisor independente e limpeza cirúrgica
- O que é o Playwright MCP nesse tutorial?
- Por que rodar os testes não basta?
- O que é a katalepsis?
- Onde coloco as instruções de revisão do agente?
Agente IA testar navegador Playwright: 5 passos para o agente checar o próprio trabalho no browser
Quer fazer seu agente IA testar navegador Playwright de verdade? Um tutorial publicado em 20 de outubro de 2026 no freeCodeCamp News mostra o loop completo.
O autor, Timothy Ogbemudia, conta que cansou de ouvir "implementado e verificado" de agente que só rodou os testes. A receita dele: dar um navegador real ao agente, escrever as regras do que conta como prova e deixar um revisor independente conferindo.
Por que só teste não basta
Agente de código tem um loop decente para código: lê, edita, roda formatador e testes, vê a falha e tenta de novo. O que faltava era a entrada do frontend. Um teste verde não diz se a tela quebrou.
O autor lista bugs que os testes não pegaram nele: controle sobreposto a outro elemento, estado selecionado que existe no store mas não aparece na tela, reset que funciona para um caminho e não para outro.
Também filtro que deixa dados antigos na página, salvar que parece ok até dar refresh, camada de mapa na ordem errada e modal que abre mas não cabe na tela.
Passo 1: dê um navegador de verdade ao agente
O Playwright MCP entrega um navegador ao agente em vez de só rodar a suite de testes. A configuração pede Node 20 ou superior e um cliente com MCP, como Claude Code, Codex ou Cursor:
- adicione o servidor MCP com o comando `npx @playwright/mcp@latest`;
- com o navegador nas mãos, o agente abre localhost, lê a página, encontra controles, clica, digita e tira screenshot;
- isso é diferente de rodar `pnpm playwright test`: a suite prova os cenários que você já escreveu, a revisão no navegador vai atrás do que essa mudança específica poderia ter quebrado.
Passo 2: faça o teste de sanidade no TodoMVC
Antes de confiar, peça para o agente abrir o demo TodoMVC do Playwright, adicionar uma tarefa chamada "Browser QA" e confirmar que ela apareceu na lista. Se ele consegue isso, ele tem navegador. O que ele faz com o navegador é a parte difícil.
Um agente com navegador mas sem instruções faz QA fraca. O autor mostrou relatório tipo "abri /rota, página carregou, verificação completa". Isso é relatório de abrir página, não de testar a mudança.
Passo 3: escreva as regras do que conta como prova
As regras que o autor escreveu viraram a definição de "pronto" para qualquer coisa visível ao usuário: o que testar, o que checar e que evidência o agente precisa trazer de volta.
Essas regras começaram como linhas repetidas no prompt e viraram uma rotina reutilizável do MCP, com a parte fixa no AGENTS.md do projeto.
Passo 4: suba o app do jeito que o projeto já sobe
O loop completo é: editar o código, rodar os testes, subir o app com o script de dev do projeto, usar a feature que mudou, olhar o que aconteceu, corrigir o que quebrou e usar de novo.
Esse último "usar de novo" importa. Agente adora dizer que "agora deve funcionar", e o autor prefere que ele abra a página de novo e descubra.
Passo 5: revisor independente e limpeza cirúrgica
Um agente revisor separado pega bug que o agente autor não vê, porque não tem apego ao próprio código. Na hora de limpar, o agente deve remover só o que ele iniciou, checando o git status antes e depois.
O autor transformou esse fluxo na ferramenta open source katalepsis, que exige Node 22.12 ou superior e Git. Ela decide se um check realmente passou em vez de aceitar "página carregou".
Perguntas frequentes
O que é o Playwright MCP nesse tutorial?
É um servidor MCP que dá um navegador real ao agente de código, instalado com `npx @playwright/mcp@latest` e exige Node 20 ou superior.
Por que rodar os testes não basta?
Porque a suite cobre só os cenários escritos antes. Bugs de interface, como elemento sobreposto ou estado que não aparece na tela, passam pelos testes e só aparecem com alguém usando o app.
O que é a katalepsis?
É a ferramenta open source que o autor do tutorial criou a partir desse fluxo. Ela dá ao agente a capacidade de decidir se uma verificação no navegador realmente passou. Precisa de Node 22.12+ e Git.
Onde coloco as instruções de revisão do agente?
O tutorial sugere dividir entre o AGENTS.md do projeto e uma rotina reutilizável do MCP, com as regras do que testar e que evidência trazer.
Quer montar esse loop no seu projeto? Veja o tutorial completo no freeCodeCamp e comece pelo passo do TodoMVC.
Aproveite para ler como usar IA no dia a dia da programação e comparar regimes na calculadora CLT × PJ. Fique de olho no quanto paga a vaga no simulador de salário.