Repolode
antiwork

antiwork/shortest

Framework de testes end-to-end com IA, em que os testes são descritos em linguagem natural, desenvolvido com Playwright e Anthropic Claude.

Estrelas
5,698
Forks
341
Issues abertas
2
Último commit
há 3 meses

O que é?

Shortest é um framework de testes end-to-end que permite descrever um teste de navegador em linguagem natural, sem escrever seletores e scripts passo a passo. Cada teste é uma string em linguagem natural passada para uma chamada a shortest(), e um modelo de IA baseado na API Anthropic Claude executa as etapas em um navegador desenvolvido com Playwright.

O framework é instalado por meio de um comando init que adiciona o pacote como dependência de desenvolvimento, cria um arquivo shortest.config.ts e configura campos para a chave da API da Anthropic em .env.local. Os testes são encontrados usando um padrão de arquivos configurável e executados pela linha de comando, opcionalmente por arquivo ou número de linha, e podem rodar em modo headless no CI. Funções de callback são executadas após a sessão do navegador, permitindo adicionar verificações como consultas ao banco de dados. Também há suporte a hooks de ciclo de vida, fluxos de testes encadeados e testes de endpoints de API.

O projeto inclui helpers integrados para login no GitHub com autenticação de dois fatores e validação de e-mail por meio do Mailosaur. Ele é escrito em TypeScript e tem como alvo aplicações Next.js, com exemplos no diretório examples.

Recursos principais

  • 01Escreva testes como descrições em linguagem natural, em vez de scripts baseados em seletores.
  • 02Usa a API Anthropic Claude para executar etapas de teste no navegador.
  • 03Desenvolvido com Playwright, com opções configuráveis para o contexto do navegador.
  • 04Oferece suporte ao login no GitHub, incluindo autenticação de dois fatores.
  • 05Valida e-mails de login por meio do Mailosaur.
  • 06Oferece hooks de ciclo de vida, testes encadeados e testes de endpoints de API.

Casos de uso

  • Adicionar cobertura de testes end-to-end a uma aplicação Next.js sem manter seletores frágeis.
  • Testar fluxos de login, incluindo o login no GitHub com 2FA.
  • Executar testes de navegador em modo headless em um pipeline de CI/CD.
  • Combinar verificações de UI com asserções de banco de dados em um callback.

Início rápido

  1. 1

    Inicialize o Shortest no seu projeto com o comando init

    npx @antiwork/shortest init
  2. 2

    Adicione sua chave de API da Anthropic a .env.local (ANTHROPIC_API_KEY)

  3. 3

    Crie um arquivo de teste em linguagem natural, como app/login.test.ts

  4. 4

    Execute todos os testes

    pnpm shortest

Antes de usar

  • Cada execução de teste chama a API do Anthropic Claude, então você precisa de uma chave de API e haverá custos de uso.
  • Os resultados dependem da execução da IA e podem variar a cada execução.
  • Alguns recursos, como a autenticação de dois fatores do GitHub e a validação de e-mail, exigem serviços de terceiros adicionais.

Em coleções

Tópicos

Perguntas frequentes

O que é shortest?
Framework de testes end-to-end com IA, em que os testes são descritos em linguagem natural, desenvolvido com Playwright e Anthropic Claude. Shortest é um framework de testes end-to-end que permite descrever um teste de navegador em linguagem natural, sem escrever seletores e scripts passo a passo. Cada teste é uma string em linguagem natural passada para uma chamada a shortest(), e um modelo de IA baseado na API Anthropic Claude executa as etapas em um navegador desenvolvido com Playwright.
shortest é gratuito? Qual é a licença?
shortest é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
shortest ainda é mantido?
Atualizado nos últimos 6 meses. O último commit de shortest foi em 6 de ago. de 2026.
Para que posso usar shortest?
Adicionar cobertura de testes end-to-end a uma aplicação Next.js sem manter seletores frágeis. Testar fluxos de login, incluindo o login no GitHub com 2FA. Executar testes de navegador em modo headless em um pipeline de CI/CD. Combinar verificações de UI com asserções de banco de dados em um callback.
Como instalar shortest?
Inicialize o Shortest no seu projeto com o comando init: npx @antiwork/shortest init Adicione sua chave de API da Anthropic a .env.local (ANTHROPIC_API_KEY) Crie um arquivo de teste em linguagem natural, como app/login.test.ts Execute todos os testes: pnpm shortest
Onde consigo shortest?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/antiwork/shortest

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados