Qualidade
Executar Testes (Jest)
Endpoint interno para executar a suíte de testes e obter um resumo.
Endpoint protegido por variável de ambiente e token opcional. Não habilite em produção a menos que você saiba o que está fazendo.
POST /api/tests/run
Executa a suíte de testes usando Jest e retorna um resumo com contagens de testes e suites.
Parâmetros de query/header
token
(query): Token opcional para acesso. Alternativa ao headerx-test-token
.x-test-token
(header): Token opcional para acesso. Tem precedência sobretoken
.watch
(query, boolean): Executa em modo watch. Padrãofalse
.coverage
(query, boolean): Coleta cobertura. Padrãofalse
.testPathPattern
(query, string): Regex para filtrar caminhos de testes.testNamePattern
(query, string): Regex para filtrar nomes de testes.
Exemplo de requisição
curl -X POST "$BASE_URL/api/tests/run?coverage=true&testPathPattern=unit" \
-H "x-test-token: $TEST_ENDPOINT_TOKEN"
Exemplo de resposta (200)
{
"success": true,
"numTotalTests": 42,
"numPassedTests": 40,
"numFailedTests": 2,
"numPendingTests": 0,
"numTotalTestSuites": 10,
"numPassedTestSuites": 9,
"numFailedTestSuites": 1,
"numRuntimeErrorTestSuites": 0,
"startTime": 1736950000000,
"endTime": 1736950050000,
"coverageMap": "enabled"
}
Erros comuns
- 401 Não autorizado: Token inválido ou ausente.
- 403 Endpoint desabilitado:
ENABLE_TEST_ENDPOINT
diferente detrue
. - 500 Erro ao executar testes: Jest ausente na imagem/ambiente.