<\> Casa do Dev
Notícias abrir
Ferramentas abrir
Vagas abrir
Aprender abrir
Comunidade abrir
Guia de Compras abrir

Agente IA testar navegador Playwright: 5 passos para o agente checar o próprio trabalho no browser

DA

5 min

Entusiasta das Tecnologias

Agente IA testar navegador Playwright: 5 passos para o agente checar o próprio trabalho no browser

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.

Neste artigo

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.

O que você achou deste artigo?

Responda a Pergunta do Dia Teste seu conhecimento e mantenha sua streak. Crie seu Dev Card público Perfil dev compartilhável em um único link.

Depois dessa formação...

Veja vagas em tecnologia →

Vagas relacionadas

Ver todas as vagas →
DA

Escrito por

Dagmar Cirino

Entusiasta das Tecnologias

Atualizado em 09/11/2026 •

Sou o Cirino, e desenvolvo soluções e produtos utilizando linguagens de programação e ferramentas de analytics e monitoração baseadas em Cloud. Trabalho com tecnologia desde 2010,...

Ver perfil do autor

COMPARTILHAR