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 header x-test-token.
  • x-test-token (header): Token opcional para acesso. Tem precedência sobre token.
  • watch (query, boolean): Executa em modo watch. Padrão false.
  • coverage (query, boolean): Coleta cobertura. Padrão false.
  • 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 de true.
  • 500 Erro ao executar testes: Jest ausente na imagem/ambiente.