ce-test-browser

Sobre ce-test-browser

Um fluxo de trabalho para executar testes de navegador de ponta a ponta nas páginas afetadas por uma solicitação de pull ou alterações no branch, utilizando exclusivamente a CLI do agent-browser. Ele evita deliberadamente qualquer sistema alternativo de automação de navegadores ou integração com o MCP do navegador; no Claude Code, ele não utiliza as ferramentas do Chrome MCP, e no Codex, ele não substitui outras ferramentas de navegação. O agent-browser é utilizado para abrir páginas, clicar em elementos, preencher formulários, capturar telas e extrair conteúdo renderizado. Ele aceita um argumento que pode ser um número de PR, um nome de branch, a palavra “current” ou um sinalizador --port.

O fluxo de trabalho primeiro verifica se o agent-browser está instalado e interrompe a execução, orientando a execução do comando /ce-setup caso ele esteja ausente. Em seguida, ele pergunta se deve ser executado com interface gráfica (headed) ou sem interface (headless), exceto no modo pipeline, em que o padrão é headless sem bloqueio. O escopo do teste é determinado a partir dos arquivos alterados, utilizando o `gh pr view` para um número de PR ou o `git diff` em relação ao `main` para o `current` ou um branch. Os arquivos alterados são mapeados para rotas testáveis por meio de uma tabela de padrões que abrange visões do Rails, controladores, controladores do Stimulus, ViewComponents, layouts, folhas de estilo, helpers e caminhos de aplicativos e componentes do Next.js, produzindo uma lista de URLs a serem testadas.

O gerenciamento de portas distingue o modo manual do modo pipeline. Ele determina uma porta preferencial a partir de um argumento explícito `--port`, instruções do projeto no contexto, scripts `dev/start` do `package.json`, arquivos de ambiente ou um padrão de 3000, evitando deliberadamente procurar a porta no texto. No modo pipeline, ele procura uma porta livre de forma ascendente, pois vários agentes podem ser executados em paralelo, e inicia um servidor de desenvolvimento em segundo plano se nenhum estiver em escuta, aguardando até 30 segundos; no modo manual, ele usa diretamente a porta preferencial e solicita que o usuário inicie o servidor caso este não esteja em execução. Para cada rota afetada, ele navega e captura um instantâneo interativo, utilizando o sinalizador `--headed` quando o usuário opta por assistir, e então verifica elementos-chave, como o título da página ou o cabeçalho, além dos principais elementos interativos. Use-o para validar se as páginas afetadas por uma alteração ainda são renderizadas e se comportam corretamente.

Perguntas frequentes

Qual ferramenta de automação de navegador essa habilidade utiliza?

Exclusivamente a CLI do agent-browser. Ela não utiliza as ferramentas do Chrome MCP no Claude Code nem substitui outras ferramentas de navegação no Codex.

O que acontece se o agent-browser não estiver instalado?

Ela orienta o usuário a executar /ce-setup para obter o comando de instalação atual, instalar o agent-browser e tentar novamente; em seguida, ela é interrompida, pois a habilidade não pode funcionar sem ele.

Como ela decide quais páginas testar?

Ela obtém os arquivos alterados a partir da visualização do pull request no GitHub (para um PR) ou do git diff em relação ao branch principal (para um branch ou versão atual) e, em seguida, mapeia esses arquivos para rotas usando uma tabela de padrões de arquivo para criar uma lista de URLs.

Como a porta do servidor de desenvolvimento é escolhida?

Por prioridade: um argumento explícito --port, instruções do projeto no contexto, scripts de desenvolvimento no package.json, arquivos de ambiente como o .env e, por último, o padrão 3000. Ele não procura a porta no texto.

O que muda no modo pipeline?

Ele ignora a questão de com ou sem interface gráfica e usa o modo sem interface gráfica por padrão, procura uma porta genuinamente livre a partir de baixo para cima, já que os agentes podem ser executados em paralelo, e inicia automaticamente um servidor de desenvolvimento em segundo plano caso nenhum esteja em escuta.