Framework e2e testa apps web e mobile com ações em linguagem natural

Framework agnético para testes de ponta a ponta

O repositório tester-army/e2e, hospedado no GitHub, apresenta um framework de testes de ponta a ponta (e2e) para aplicativos web e mobile no qual o desenvolvedor descreve um objetivo em linguagem natural e um agente conduz o aplicativo até esse objetivo. A verificação do resultado pode combinar asserções em linguagem natural com localizadores e assertions tradicionais no mesmo teste.

Como funciona

O exemplo do README mostra um teste em TypeScript em que o app abre a página de cobrança, o agente recebe a instrução "fazer upgrade do workspace para o plano Pro" e depois uma asserção semântica confirma que a prévia da fatura mostra valor proporcional, seguida de uma verificação clássica com expect e getByRole.

Um ponto central do mecanismo: passos de agente verificados por asserções posteriores registram suas ações, e a próxima execução as reproduz sem chamadas ao modelo, até que o aplicativo mude. Testes sem passos de agente não precisam de modelo. O framework permite usar assinatura própria, chave de API ou modelo local.

Começo rápido e pacotes

O comando npx e2e init pergunta o motor (web ou mobile) e o provedor de modelo, e gera uma configuração e um teste de exemplo. O repositório traz projetos independentes com suítes passando para Vite, Next.js, Expo e SwiftUI.

A distribuição é modular: o pacote e2e contém SDK, runner e CLI; @e2e-dev/web usa Chromium, Firefox e WebKit via Playwright; @e2e-dev/mobile cobre simuladores e emuladores de iOS e Android via agent-device; há também um reporter que publica resultados como comentário em pull request, navegadores hospedados, simuladores iOS e emuladores Android hospedados e executores de modelo de decisão para ações e asserções semânticas limitadas.

Documentação, licença e estado do projeto

A documentação fica em e2e.tester.army/docs e o pacote e2e inclui todas as páginas, permitindo que agentes de código leiam a documentação offline em node_modules/e2e/docs. O projeto usa licença Apache-2.0 e está em desenvolvimento ativo rumo à versão 1.0, com aviso de que APIs e configuração podem mudar entre versões menores.

O CLI envia telemetria anônima - comandos, motores usados e onde as execuções falham - sem conteúdo de testes, de aplicativos ou credenciais; é possível desativar com npx e2e telemetry disable ou variável de ambiente.

Origem e números

O projeto é desenvolvido pela TesterArmy, descrita como plataforma de testes agnéticos que roda testes em linguagem natural em apps web e mobile a cada pull request ou em agendamento. O repositório soma 4,2 mil estrelas, 180 forks, 644 commits e mantém 10 issues e 12 pull requests abertos.