Uma Execução de CI Falhada Não Deveria Ser Sua Primeira Pista de Que Algo Está Mal Configurado.
Antes de conectar a TestSprite à CI, execute testsprite doctor. Ele verifica se sua chave de API, acesso à rede e versão do CLI estão todos corretamente configurados — para que um problema bobo de configuração não se disfarce de uma falha de teste real.
Incorporado ao Mesmo CLI Que Você Já Usa
Verifique Sua Chave de API
O testsprite doctor confirma que sua TESTSPRITE_API_KEY está definida e válida antes que um job de CI gaste sua primeira execução com um erro de autenticação.
Verifique o Acesso à Rede e ao Proxy
Proxies corporativos e executores de CI trancados podem bloquear silenciosamente requisições de saída. O doctor confirma que o CLI consegue realmente alcançar a TestSprite antes que você descubra isso no meio do pipeline.
Confirme Sua Versão do CLI
Uma incompatibilidade de versão entre o que está instalado e o que seu pipeline espera pode falhar de formas que parecem um bug do produto. O doctor sinaliza isso antes que aconteça.
Execute em Qualquer Lugar
A mesma verificação, seja configurando localmente, conectando um novo job de CI, ou depurando por que o pipeline de um colega não autentica.
$ testsprite doctor Checking environment... ✓ API key found and valid ✓ Network access to TestSprite confirmed ✓ CLI version up to date → environment looks good, ready to run tests $ testsprite doctor Checking environment... ✗ TESTSPRITE_API_KEY not set ✗ Network request blocked — check proxy configuration → fix these before running testsprite test run
Não Deixe a CI Depurar Sua Configuração Para Você
Um pipeline que falha antes mesmo de chegar aos seus testes não está testando nada — está apenas falhando ruidosamente. Executar testsprite doctor primeiro transforma "por que a CI acabou de falhar" em uma resposta de dois segundos.
Feito para Conectar a TestSprite à CI
Execute Antes de Conectar a CI
Adicione testsprite doctor como o primeiro passo do seu pipeline — logo após a instalação, antes do testsprite setup e de qualquer execução de teste real.
Combina Com o testsprite setup
Use testsprite setup --from-env --yes --agent <name> para configurar credenciais de forma não interativa, depois execute doctor para confirmar que elas realmente funcionam.
Gratuito e Open Source
npm install -g @testsprite/testsprite-cli te dá o CLI. Tem licença Apache-2.0, então não há nada bloqueando uma primeira verificação.
Saída Legível por Máquina
Passe --output json para obter resultados em um formato que seu pipeline pode analisar e agir automaticamente.
Confiado por Empresas em Todo o Mundo
"TestSprite oferece geração rica de casos de teste, estrutura clara e código fácil de ler. Também suporta depuração online simples com a capacidade de expandir rapidamente gerando novos casos de teste."
"A automação do TestSprite nos ajuda a reduzir toneladas de trabalho manual. Os desenvolvedores podem facilmente detectar e resolver bugs mais cedo no processo de desenvolvimento."
FAQ
O que o testsprite doctor realmente verifica?
Ele verifica se sua chave de API está definida e válida, se o CLI consegue alcançar a TestSprite pela sua rede — inclusive através de um proxy — e se sua versão instalada do CLI está atualizada.
Quando eu devo executá-lo?
Logo após instalar o CLI, e novamente como o primeiro passo de qualquer novo pipeline de CI — antes do testsprite setup ou de uma execução de teste real, para que um problema de configuração falhe rápido em vez de no meio do pipeline.
Qual a diferença disso em relação a simplesmente rodar um teste e ver o que quebra?
Uma execução de teste falhada causada por uma chave de API ausente ou uma requisição de rede bloqueada parece idêntica a uma falha real do produto até você investigar. O doctor separa "sua configuração está quebrada" de "seu produto está quebrado" antes que você desperdice uma execução no problema errado.
Isso funciona na CI, ou só localmente?
Ambos — é o mesmo comando de qualquer forma. Execute localmente enquanto estiver configurando, e depois novamente como uma etapa de CI para que um problema de proxy ou credencial no ambiente do pipeline não passe despercebido.
E se ele sinalizar um problema?
Ele aponta o que está errado — uma TESTSPRITE_API_KEY ausente, um caminho de rede bloqueado, ou uma versão desatualizada do CLI — para que você corrija essa única coisa em vez de depurar uma execução de teste que nunca teve chance de começar.