Guia de configurações: o que cada configuração faz
Abra as configurações no Studio e veja a explicação de cada opção logo abaixo do nome. Esta página reúne essas mesmas explicações em um só lugar para você ler com antecedência, pesquisar ou pedir a um assistente de IA que explique cada uma.
Última atualização:
Como as configurações funcionam
- Altere e depois salve. Edite o que precisar e pressione Salvar alterações. Um ponto ao lado de uma configuração indica que ela foi alterada, mas ainda não foi salva.
- A maioria das pessoas altera muito pouco. Cada configuração tem um valor padrão adequado. Se tiver dúvidas, deixe como está.
- Os segredos ficam no seu computador. Senhas, tokens e chaves são salvos no arquivo
.envdo seu espaço de trabalho e exibidos como pontos. Nada é enviado para nós. - O nome em cinza é o nome da configuração no arquivo. É a linha no
.env, caso você a defina por meio de um pipeline ou script.
Segurança & Autenticação
Autenticação para testes de API.
| Configuração | O que faz | Padrão |
|---|---|---|
Token de API ou senhaAPI_AUTH_TOKEN | A credencial secreta verificada pela sua API, obtida na página da conta do seu provedor de API; para Basic, digite user:password. Vazio significa sem autenticação; os relatórios mostram apenas os 4 primeiros caracteres. | Vazio. Salvo apenas neste computador. |
Método de autenticação da APIAPI_AUTH_TYPE | Como sua API verifica quem está fazendo a chamada: Bearer envia um token, Basic um nome de usuário e uma senha, ApiKey uma chave em um cabeçalho. O padrão é Bearer. | Bearer |
Nome do cabeçalho da chave de APIAPI_AUTH_HEADER | Somente para ApiKey: o nome do cabeçalho que contém sua chave, como api-key. Deixe em branco para usar X-Api-Key. | Empty |
Smart Monkey
Verificações extras de segurança da API durante a exploração.
| Configuração | O que faz | Padrão |
|---|---|---|
Verificação passiva de segurança da APINEXUS_API_AUDIT | Durante a exploração, lê as respostas de API que seu aplicativo já recebe e sinaliza vulnerabilidades como vazamentos de dados, sem enviar nada extra. Desativado por padrão; use apenas em aplicativos que você tem permissão para testar. | false |
Verificação de desvio de autenticaçãoNEXUS_API_ACTIVE | Repete sem o token de login as requisições de dados que seu aplicativo fez com ele, para verificar se o servidor ainda responde. Apenas leitura, mas envia requisições extras; desativado por padrão. | false |
Alvos & API
Endereços de API, limites de velocidade e evidências salvas.
| Configuração | O que faz | Padrão |
|---|---|---|
Endereço principal da APIAPI_BASE_URL | O endereço base dos testes de API que têm apenas um caminho (como /users), por exemplo, https://api.example.com. Deixe vazio: um valor aqui também redireciona todos os testes de API gravados para esse endereço. | Empty |
Endereço GraphQLAPI_GRAPHQL_URL | O endereço do seu serviço GraphQL (uma API em que você solicita exatamente os dados que deseja). Se estiver vazio, os exemplos integrados de GraphQL consultam um serviço público de demonstração, não o seu. | Empty |
Resposta mais lenta permitidaNEXUS_API_LATENCY_BUDGET | Tempo máximo de resposta de uma API, em milissegundos (1000 = 1 segundo); respostas que ultrapassam esse tempo são marcadas como lentas. O padrão é 2000 (2 segundos). | 2000 |
Repetições de medição de tempo por requisiçãoNEXUS_API_SAMPLES | Quantas vezes cada requisição de API é enviada para medir a velocidade com precisão (1 a 200); apenas a primeira resposta é verificada. O padrão é 20; reduza se as repetições sobrecarregarem seu servidor. | 20 |
Repetir requisições que alteram dadosNEXUS_API_SAMPLE_WRITES | Também repete requisições que criam ou alteram dados (POST, PUT, PATCH, DELETE). Desativado por padrão, pois 20 repetições criariam 20 registros no seu servidor. | false |
Falhar se houver alterações nas respostasNEXUS_API_DRIFT_STRICT | Uma resposta que ganha um campo ou muda um tipo de dado é sempre reportada como divergente. Ative para também reprovar o teste; desativado (padrão), apenas reporta a divergência. | false |
Execuções de API aprovadas mantidasNEXUS_API_EVIDENCE_KEEP | Quantas execuções bem-sucedidas de cada teste de API mantêm suas evidências salvas; as mais antigas são excluídas, mas as execuções com falha nunca são. O padrão é 20; 0 mantém todas as execuções. | 20 |
Tamanho máximo da resposta salvaNEXUS_API_BODY_MAX_KB | Tamanho máximo do corpo de requisição ou resposta salvo nos arquivos de evidências, em KB; corpos maiores são truncados e salvos com seu tamanho total e uma impressão digital. O padrão é 256 KB. | 256 |
Falhar se as respostas estiverem lentasNEXUS_API_PERF_STRICT | Ative para reprovar um teste de API quando uma resposta demorar mais que o tempo permitido acima. Desativado (padrão): uma resposta lenta apenas gera um aviso. | false |
Verificar cabeçalhos de segurança da APINEXUS_API_SECURITY_HEADERS | Verifica se as respostas da API incluem os cabeçalhos de proteção padrão (por exemplo Content-Security-Policy); os ausentes são indicados como recomendações e nunca causam a falha de um teste por si só. Ativado por padrão. | true |
Aplicativo em teste
Iniciar seu aplicativo automaticamente antes das execuções.
| Configuração | O que faz | Padrão |
|---|---|---|
Comando que inicia seu aplicativoNEXUS_APP_START | Inicia seu aplicativo antes de cada execução e o encerra depois, por exemplo npm run dev; em branco = você o inicia manualmente. Apenas um comando: coloque encadeamentos como && em um script do package.json. | Empty |
Pasta do aplicativoNEXUS_APP_CWD | Caminho completo da pasta de onde seu aplicativo é iniciado, onde fica o package.json; se estiver vazio, usa a pasta deste espaço de trabalho. Em uma máquina remota, é uma pasta nessa máquina. | Empty |
Endereço que indica prontidãoNEXUS_APP_READY_URL | O endereço web verificado a cada meio segundo para saber se seu aplicativo foi iniciado; qualquer resposta, exceto um erro de servidor, é válida. Se estiver vazio, usa seu endereço principal de teste (BASE_URL). | Empty |
Limite de espera para inicializaçãoNEXUS_APP_TIMEOUT_MS | Quanto tempo esperar até que seu aplicativo esteja pronto, em milissegundos (1000 = 1 segundo); se demorar mais, a execução não será iniciada. O padrão é 120000 (2 minutos). | 120000 |
Reutilizar um aplicativo em execuçãoNEXUS_APP_REUSE | Ativado: se seu aplicativo já responder no endereço de prontidão, ele será usado e continuará em execução; desativado: a execução para com um erro para que você nunca teste outra coisa por engano. Ativado por padrão. | true |
Execução & Tempos limite
Quantos testes executar e quanto tempo esperar.
| Configuração | O que faz | Padrão |
|---|---|---|
Navegadores por testeNEXUS_PARALLEL_BROWSERS | Quantos navegadores executam um teste ao mesmo tempo, de 1 a 3; o padrão 1 é o mais seguro, 2 precisam de cerca de 8 GB de memória e 3 de cerca de 16 GB. Uma execução restrita a um navegador sempre usa apenas um. | 1 |
Testes simultâneosNEXUS_PARALLEL_TCS | Quantos testes são executados em paralelo em uma execução completa, de 1 a 32; o padrão é 1 (um após o outro). Cada teste extra precisa de cerca de 0.5 GB de memória por navegador, então aumente apenas em um PC potente. | 1 |
Tentar novamente os testes com falhaNEXUS_RETRY_ENABLED | Um teste que falha é executado mais uma vez antes de ser reportado, o que filtra falhas pontuais. Desative para ver todas as falhas imediatamente; ativado por padrão. | true |
Limite de tempo por testeNEXUS_TC_TIMEOUT | Tempo máximo de execução de um teste, em segundos, antes de ser interrompido à força. O padrão é 360 (6 minutos); o próprio teste para 1 minuto antes para salvar suas evidências. | 360 |
Tempo de espera para verificaçõesNEXUS_EXPECT_TIMEOUT | Quanto tempo uma verificação (como "este texto aparece") espera para ser satisfeita, em milissegundos (1000 = 1 segundo); aumentar esse valor ajuda em páginas lentas sem ocultar falhas. O padrão é 10000 (10 segundos). | 10000 |
Espera por clique ou digitaçãoNEXUS_ACTION_TIMEOUT | Quanto tempo uma etapa como clicar ou digitar espera até que seu alvo esteja pronto, em milissegundos (1000 = 1 segundo). Aumente para páginas lentas; o padrão é 30000 (30 segundos). | 30000 |
Limite de tempo de abertura da páginaNEXUS_NAV_TIMEOUT | Quanto tempo a abertura de uma página pode levar antes que a etapa falhe, em milissegundos (1000 = 1 segundo). O padrão é 60000 (1 minuto); aumente para sites muito lentos. | 60000 |
Espera após abrir a páginaNEXUS_LOAD_WAIT_MS | Após abrir uma página, aguarda até este número de milissegundos (1000 = 1 segundo) para que ela termine de carregar, evitando cliques prematuros. Nunca reprova um teste; 0 desativa a espera, o padrão é 8000. | 8000 |
Falhar se faltarem cabeçalhos de segurançaNEXUS_SECURITY_STRICT | Ative para reprovar um teste quando as páginas do seu aplicativo não tiverem cabeçalhos de proteção (como Content-Security-Policy). Desativado (padrão), apenas registra isso no relatório; em um aplicativo antigo, isso pode reprovar todos os testes. | false |
Localização do FirefoxNEXUS_FIREFOX_BINARY | Caminho completo para firefox.exe, usado apenas por testes do Selenium; vazio = procurar nos locais habituais. Um caminho incorreto é considerado ausência do Firefox, então esses testes do Selenium são ignorados. | Empty |
Testes que falham de propósitoNEXUS_FIXTURE_TCS | IDs dos testes criados para falhar de propósito, separados por vírgulas. Eles ficam fora da Classificação de Risco, a menos que você solicite sua inclusão; vazio por padrão. | Empty |
Seletores & Autocorreção
Detecção e correção de seletores frágeis.
| Configuração | O que faz | Padrão |
|---|---|---|
Avisos de etapas frágeisNEXUS_SMART_SELECTORS | Quando um teste é gravado ou importado, Sugerir adiciona um comentário acima de cada etapa que localiza elementos de forma frágil; Desativado não adiciona nenhum. Testes já escritos não são alterados; o padrão é Sugerir. | suggest |
Sugestões de reparo automáticoNEXUS_SELF_HEAL | Após uma falha, prepara correções em um navegador em segundo plano (etapa ignorada quando há pouca RAM ou uma execução em andamento). Sugerir exibe as correções, Verificar também as testa em 3 navegadores, Desativado não faz nada. | suggest |
MLOps & Predição
Prever quais testes não são confiáveis.
| Configuração | O que faz | Padrão |
|---|---|---|
Atualizar previsão de testes instáveisNEXUS_AUTO_PREDICT | Após cada execução, atualiza a previsão de quais testes são instáveis (às vezes passam, às vezes falham) para manter a Classificação de risco atualizada. Ativado por padrão. | true |
Acessibilidade
Auditoria WCAG via axe-core.
| Configuração | O que faz | Padrão |
|---|---|---|
Verificar acessibilidadeNEXUS_A11Y_ENABLED | Verifica se há barreiras nas páginas que impedem o acesso de pessoas com deficiência, como baixo contraste ou rótulos ausentes. Desativado por padrão; requer o complemento @axe-core/playwright e, sem ele, a verificação é ignorada. | false |
Conjunto de regras de acessibilidadeNEXUS_A11Y_STANDARD | Seleciona as diretrizes de acessibilidade (WCAG) para a verificação: versão 2.0, 2.1 ou 2.2, no nível A (básico) ou AA (padrão). O padrão, 2.1 AA, é o requisito legal mínimo usual na Europa. | wcag21aa |
Gravidade mínima do problemaNEXUS_A11Y_FAIL_LEVEL | Qual deve ser a gravidade de um problema (leve, moderado, grave, crítico) para contar como violação. O padrão é grave; só tem efeito se 'Reprovar o teste em caso de violação' estiver ativado. | serious |
Falhar o teste em caso de violaçãoNEXUS_A11Y_STRICT | Quando ativado, um teste que encontra um problema com gravidade igual ou superior à mínima é marcado como reprovado (A11Y_VIOLATION). Desativado por padrão: os problemas são apenas listados no relatório. | false |
Performance
Limites de Core Web Vitals.
| Configuração | O que faz | Padrão |
|---|---|---|
Medir a velocidade da páginaNEXUS_PERF_ENABLED | Mede a rapidez com que cada página carrega e reage (Core Web Vitals) e a compara com os limites abaixo. Ativado por padrão; apenas adiciona dados e nunca reprova um teste, a menos que 'Reprovar em páginas lentas' esteja ativado. | true |
Limite de carregamento do conteúdo principalNEXUS_PERF_LCP | Tempo máximo, em milissegundos (1000 = 1 segundo), para o conteúdo principal de uma página aparecer. O padrão é 2500 (2.5 segundos), valor considerado 'bom' pelo Google; aumente-o para sites lentos. | 2500 |
Limite de carregamento do primeiro conteúdoNEXUS_PERF_FCP | Tempo máximo, em milissegundos (1000 = 1 segundo), até a página exibir seu primeiro texto ou imagem. O padrão é 1800 (1.8 segundos), valor considerado 'bom' pelo Google; aumente-o para sites lentos. | 1800 |
Limite de deslocamento da páginaNEXUS_PERF_CLS | Quanto os elementos da página podem se deslocar durante o carregamento, em uma pontuação em que 0 significa estabilidade perfeita. O padrão é 0.1, a classificação 'boa' do Google; um número menor é mais rigoroso. | 0.1 |
Limite de elementos da páginaNEXUS_PERF_DOM | Quantidade máxima de elementos (botões, blocos de texto, imagens) que uma página pode ter antes de ser marcada como pesada para dispositivos lentos. O padrão é 1500. | 1500 |
Limite de memória da páginaNEXUS_PERF_HEAP | Quantidade máxima de memória, em MB, que os scripts de uma página podem usar antes de ela ser sinalizada. O padrão é 50 MB; a medição só é feita em navegadores baseados em Chromium, como Chrome e Edge. | 50 |
Limite de resposta ao cliqueNEXUS_PERF_INP | Tempo máximo, em milissegundos (1000 = 1 segundo), para uma página reagir após um clique ou toque. O padrão é 200, valor considerado 'bom' pelo Google; aumente-o para sites lentos. | 200 |
Limite de travamento da páginaNEXUS_PERF_TBT | Tempo máximo, em milissegundos (1000 = 1 segundo), que uma página pode ficar travada e ignorar cliques durante o carregamento. O padrão é 200, valor considerado 'bom' pelo Lighthouse (ferramenta de auditoria do Google). | 200 |
Limite de resposta do servidorNEXUS_PERF_TTFB | Tempo máximo, em milissegundos (1000 = 1 segundo), para o servidor começar a enviar a página. O padrão é 800; resultados lentos geralmente indicam um problema no servidor, não no design da página. | 800 |
Tolerância à lentidãoNEXUS_PERF_TOLERANCE | Quanto uma página pode ficar mais lenta em relação aos próprios resultados anteriores antes que o Evidence Locker sinalize uma regressão. O padrão 1.25 significa 25% mais lenta; valores de 1 ou menos são substituídos por 1.25. | 1.25 |
Falhar se as páginas estiverem lentasNEXUS_PERF_STRICT | Quando ativado, uma página que ultrapassa qualquer limite de velocidade acima faz o teste ser marcado como reprovado (PERFORMANCE_DEGRADED). Desativado por padrão: páginas lentas são apenas registradas no relatório. | false |
Verificar carregamento de imagensNEXUS_LAZY_ENABLED | Verifica se as imagens carregam de forma a manter as páginas rápidas, por exemplo sem atrasar a imagem principal. Ativado por padrão, exige a medição de velocidade ativada e atribui uma pontuação de 0 a 100 sem causar falhas nos testes. | true |
Limite da imagem no carregamento inicialNEXUS_LAZY_MAX_INITIAL_IMG_KB | Quantidade máxima de dados de imagem, em KB (1000 KB equivalem a cerca de 1 MB), que uma página pode baixar ao abrir pela primeira vez antes de ser sinalizada pela verificação. O padrão é 1000 KB. | 1000 |
Falhar se houver problemas nas imagensNEXUS_LAZY_STRICT | Quando ativado, um teste é marcado como reprovado (PERFORMANCE_DEGRADED) se a imagem principal tiver seu carregamento adiado deliberadamente ou se as imagens do carregamento inicial ultrapassarem o limite acima. Desativado por padrão: apenas registra no relatório. | false |
Teste de carga
Limites para testes de estresse de tráfego.
| Configuração | O que faz | Padrão |
|---|---|---|
Limite de tempo de respostaNEXUS_LOAD_P95 | Em uma execução de carga, 95% das requisições devem terminar dentro deste tempo em milissegundos (1000 = 1 segundo). Em branco significa sem limite, então o resultado indica 'não avaliado'; o limite próprio de um cenário tem prioridade. | Empty |
Porcentagem de erros permitidaNEXUS_LOAD_ERROR_RATE | Quantidade máxima de requisições com falha em uma execução de teste de carga, em porcentagem de 0 a 100 (5 significa que 5 a cada 100 podem falhar). Em branco significa sem limite; o limite do próprio cenário tem prioridade sobre este. | Empty |
Falhar a execução se o limite não for atendidoNEXUS_LOAD_STRICT | Quando ativado, uma execução de carga que ultrapassa seu limite de tempo de resposta ou de erros termina como reprovada, o que interrompe as compilações automatizadas. Desativado por padrão: o resultado é apenas registrado no relatório. | false |
Quantidade de processos de cargaNEXUS_LOAD_POOL | Quantos processos em segundo plano geram o tráfego em uma execução de carga. Em branco, usa um por núcleo do processador, nunca mais que o número de usuários simulados; cada um consome cerca de 80 MB no Windows. | Empty |
Hardware & Ritmo
Desacelerar testes em computadores com pouca memória.
| Configuração | O que faz | Padrão |
|---|---|---|
Ajustar o ritmo dos testes pela RAM livreNEXUS_HW_MONITOR_ENABLED | Quando ativado, o aplicativo espera mais entre testes e executa menos testes ao mesmo tempo quando há pouca RAM livre. Desativado por padrão (espera fixa); ative em computadores com poucos recursos ou muito ocupados. | false |
Espera entre testesNEXUS_HW_FIXED_PAUSE_MS | Espera entre testes em execuções com vários testes, em milissegundos (1000 = 1 segundo), quando o ajuste de ritmo por RAM está desativado. O padrão é 2000 (2 segundos); uma execução com um único teste nunca espera. | 2000 |
Limite de RAM do PC compactoNEXUS_HW_CRITICAL_GB | Computadores com RAM total inferior a este valor, em GB, são considerados muito pequenos e têm o maior tempo de espera entre testes. O padrão é 4; usado apenas quando o intervalo baseado na RAM está ativado. | 4 |
Limite de RAM para PC com poucos recursosNEXUS_HW_LIMITED_GB | Computadores com RAM total inferior a este valor, em GB, são considerados pequenos. O padrão é 8; usado apenas quando o intervalo baseado na RAM está ativado, e deve ser maior que o limite para computadores muito pequenos. | 8 |
Limite de RAM para PC padrãoNEXUS_HW_NORMAL_GB | Computadores com RAM total inferior a este valor, em GB, são considerados padrão; acima dele, são considerados potentes e têm o menor tempo de espera. O padrão é 16; usado apenas quando o intervalo baseado na RAM está ativado. | 16 |
Espera quando há bastante RAM livreNEXUS_PAUSE_LOW_MS | Espera entre testes, em milissegundos (1000 = 1 segundo), quando a maior parte da RAM está livre. 0 (padrão) usa um intervalo predefinido de 1 a 3 segundos conforme a capacidade do PC, não elimina a espera; usado apenas com o ajuste de ritmo por RAM ativado. | 0 |
Espera com uso moderado de RAMNEXUS_PAUSE_MEDIUM_MS | Espera entre testes, em milissegundos (1000 = 1 segundo), quando o uso de RAM é moderado. 0 (padrão) usa um intervalo predefinido de 2 a 8 segundos conforme a capacidade do PC, não elimina a espera; usado apenas com o ajuste de ritmo por RAM ativado. | 0 |
Espera quando a RAM livre fica baixaNEXUS_PAUSE_HIGH_MS | Espera entre testes, em milissegundos (1000 = 1 segundo), quando a RAM livre está ficando baixa. 0 (padrão) usa um intervalo predefinido de 4 a 15 segundos conforme a capacidade do PC, não elimina a espera; usado apenas com o ajuste de ritmo por RAM ativado. | 0 |
Espera quando a RAM está cheiaNEXUS_PAUSE_CRITICAL_MS | Espera entre testes, em milissegundos (1000 = 1 segundo), quando a RAM está quase cheia. 0 (padrão) usa um intervalo predefinido de 8 a 25 segundos conforme a capacidade do PC, não elimina a espera; usado apenas com o ajuste de ritmo por RAM ativado. | 0 |
Devices & Mobile
Celulares para testar e emular.
| Configuração | O que faz | Padrão |
|---|---|---|
Porta de conexão do celularNEXUS_DEVICE_CDP_PORT | O número da porta de rede que seu computador usa para se comunicar com o Chrome em um celular Android conectado. Altere apenas se outro programa já usar 9333, o valor padrão. | 9333 |
ID do aplicativo de navegador do celularNEXUS_DEVICE_CHROME_PKG | O ID do aplicativo do navegador a ser testado em um celular Android conectado. Altere apenas se o celular usar outro navegador; o padrão é o Chrome comum (com.android.chrome). | com.android.chrome |
Controlar celular pelo PCNEXUS_MIRROR_CONTROL | Permite tocar e digitar no celular pela janela espelhada no seu computador. Desative para ter uma janela apenas de visualização que ignora seus cliques; o padrão é ativado. | true |
Celular avançado a simularNEXUS_TIER_HIGH_DEVICE | O modelo de celular imitado nas execuções de alto desempenho: tamanho da tela, identificação do navegador e toque. É uma simulação no mecanismo do Safari, não um iPhone físico; o padrão é iPhone 13. | iPhone 13 |
Celular intermediário a simularNEXUS_TIER_MID_DEVICE | O modelo de celular simulado nas execuções móveis padrão: tamanho da tela, identificação do navegador e toque. Escolha um celular Android; o padrão é Pixel 5. | Pixel 5 |
Celular básico a simularNEXUS_TIER_LOW_DEVICE | O modelo de celular simulado nas execuções de baixo desempenho, que também reduzem a velocidade do processador. Escolha um celular Android; se deixar vazio, será usado um modelo básico integrado (Nokia 1). | Empty |
Fator de desaceleração para celulares básicosNEXUS_CPU_THROTTLE_RATE | Quantas vezes mais lento o processador funciona nos testes de celulares básicos, para simular um celular pouco potente. Use de 2 a 20 (quanto maior, mais lento); o padrão é 4, apenas em navegadores baseados no Chrome. | 4 |
Rede lentaNEXUS_NETWORK_PROFILE | Executa todos os testes em uma conexão mais lenta para ver como seu site se comporta com um sinal móvel fraco: off (padrão), fast-4g, slow-4g, slow-3g ou offline. Apenas navegadores baseados no Chrome e celulares Android reais. | desativado |
Evidências & Retenção
Quais evidências salvar e por quanto tempo.
| Configuração | O que faz | Padrão |
|---|---|---|
Gravar vídeos de falhasNEXUS_VIDEO_ENABLED | Grava um vídeo de cada teste para que ele possa ser mantido em caso de falha. Desative para economizar recursos do computador e espaço em disco, mas nenhuma falha terá vídeo; ativado por padrão. | true |
Falhas cujos vídeos são mantidosNEXUS_VIDEO_VERDICTS | Escolha quais resultados mantêm seus vídeos: falhas, falhas após novas tentativas, falhas sob caos, tempo esgotado ou bloqueios. Vazio ou nenhum não mantém vídeos; o padrão são os três primeiros. | BREACHED,BREACHED_FLAKY,CHAOS_BREACHED |
Gravar reprodução passo a passoNEXUS_TRACE_ENABLED | Registra cada ação e estado da página de cada teste e salva a reprodução junto ao relatório de erro em caso de falha. Desative em computadores com poucos recursos para economizar processamento; ativado por padrão. | true |
Relatórios de erros mantidos por testeNEXUS_BUGREPORT_RETAIN | Quantos relatórios de falha manter para cada teste e navegador. Os mais antigos são excluídos permanentemente, então aumente esse valor se precisar de um histórico mais longo; o padrão é 20. | 20 |
Capturas de tela de testes aprovados mantidasNEXUS_PASSED_RETAIN | Quantas capturas de tela de execuções bem-sucedidas manter para cada teste e navegador. As mais antigas são excluídas permanentemente; o padrão é 5. | 5 |
Sessões do Smart Monkey mantidasNEXUS_MONKEY_RETAIN | Quantas sessões do Smart Monkey (cliques e digitação aleatórios no seu aplicativo) manter. Sessões mais antigas são excluídas permanentemente; o padrão é 10. | 10 |
Registros de execução mantidosNEXUS_RUN_CONTEXT_RETAIN | Quantas execuções mantêm um registro do ambiente testado, além do registro do aplicativo. Registros mais antigos são excluídos permanentemente; o padrão é 100. | 100 |
Manter evidências de testes que passaram após falharNEXUS_RECOVERED_RETAIN | Salva uma captura de tela e notas para testes que passaram somente após uma nova tentativa ou após o aplicativo corrigir sozinho um elemento alterado da página. Desative para não guardar nada desses testes; ativado por padrão. | true |
Limite total de evidências (GB)NEXUS_EVIDENCE_MAX_GB | O espaço máximo em disco que todas as evidências podem usar. Após cada execução, as mais antigas são excluídas permanentemente, começando pelas execuções aprovadas, mas cada teste mantém sua execução mais recente; o padrão é 20 GB. | 20 |
Espaço livre em disco a manter (GB)NEXUS_MIN_FREE_GB | O espaço livre que seu disco deve manter. Abaixo desse valor, as evidências mais antigas são excluídas permanentemente, mesmo sem atingir o limite total (0 desativa isso); o padrão é 10 GB. | 10 |
Tamanho do histórico de execuçõesNEXUS_HISTORY_RETAIN | Quantos resultados anteriores manter para cada teste e navegador, usados nas tendências e nos gráficos. Aumente se um teste for executado muitas vezes ao dia; o padrão é 50. | 50 |
Privacidade & Discrição
Bloqueio de anúncios e ocultação da automação nos sites.
| Configuração | O que faz | Padrão |
|---|---|---|
Ocultar que os testes são automatizadosNEXUS_STEALTH_ENABLED | Faz o navegador de teste parecer o de uma pessoa comum, para que sites que bloqueiam robôs permitam seu acesso. Não é usado em verificações de Segurança nem em um celular físico; por padrão, fica desativado. | false |
Bloquear anúncios durante os testesNEXUS_BLOCK_ADS | Impede o carregamento de redes de anúncios durante a gravação e a execução de testes, para que janelas de anúncios não cubram os botões. Seu próprio aplicativo nunca é bloqueado; ativado por padrão, e as verificações de Segurança não usam esse recurso. | true |
Reports
Relatório executivo em PDF/HTML.
| Configuração | O que faz | Padrão |
|---|---|---|
Nome da empresa nos relatóriosORG_ID | O nome da organização impresso nos seus relatórios em PDF. O Studio o preenche com os dados do seu perfil na primeira abertura; se você deixar vazio, será usado o nome do seu computador. | Empty |
Idioma dos relatóriosNEXUS_PDF_LANGUAGE | O idioma do relatório resumido para impressão gerado após uma execução completa. Escolha inglês (en) ou espanhol (es); o padrão é inglês. | en |
Nome na assinatura dos relatóriosNEXUS_QA_ENGINEER_NAME | O nome exibido na seção de aprovação dos seus relatórios. Defina o nome da pessoa que aprova os resultados; o padrão é Engenheiro de QA. | QA Engineer |
Notifications
Alertas por teste no Telegram, Slack e Teams.
| Configuração | O que faz | Padrão |
|---|---|---|
Alerta do Telegram por falhaNEXUS_TELEGRAM_NOTIFY | Envia uma mensagem no Telegram para cada teste com falha. Funciona somente quando o Telegram também está ativado e conectado abaixo; desativado por padrão, para que ativar o Telegram não gere uma enxurrada de mensagens. | false |
Alerta no Slack por falhaNEXUS_SLACK_NOTIFY | Envia uma mensagem no Slack para cada teste com falha, instável, de caos ou com alteração visual. Funciona somente quando o Slack também está ativado e conectado abaixo; desativado por padrão. | false |
Alerta no Telegram em caso de aprovaçãoNEXUS_NOTIFY_ON_PASS | Também envia uma mensagem pelo Telegram quando um teste passa. Os alertas de falha do Telegram também precisam estar ativados, e isso gera muitas notificações em conjuntos grandes de testes; desativado por padrão. | false |
Alerta no Teams por falhaNEXUS_TEAMS_NOTIFY | Envia uma mensagem no Microsoft Teams para cada teste com falha, instável, de caos ou com alteração visual. Só funciona quando o Teams também está ativado e conectado abaixo; fica desativado por padrão. | false |
Integrações
Slack, Teams, Jira, Azure DevOps, GitHub Issues, Telegram.
| Configuração | O que faz | Padrão |
|---|---|---|
Enviar alertas para o TelegramTELEGRAM_ENABLED | Ativa o envio de resumos de testes e arquivos que você compartilha para o Telegram, um serviço externo. Desativado por padrão; mantenha desativado se sua empresa não permitir que dados saiam deste computador. | false |
Código de acesso do bot do TelegramTELEGRAM_TOKEN | O código secreto do seu próprio bot do Telegram (uma conta auxiliar gratuita). Obtenha-o enviando /newbot para @BotFather no Telegram; ele fica neste computador e nunca é compartilhado. | Vazio. Salvo apenas neste computador. |
Conversa do Telegram para alertasTELEGRAM_CHAT_ID | O número que identifica a conversa do Telegram que recebe alertas. Preenchido automaticamente quando você escaneia o código QR com Conectar em Configurações → Integrações. | Empty |
Criar chamados no Jira para falhasJIRA_ENABLED | Abre um bug no Jira quando um teste falha e o atualiza nas execuções seguintes. É ativado para você ao salvar o Jira Connect, onde você cola qualquer link do seu Jira. | false |
Endereço do site do JiraJIRA_BASE_URL | O endereço web do seu Jira, como https://yourteam.atlassian.net. Preenchido automaticamente quando você cola qualquer link do seu Jira em Conectar. | Empty |
E-mail de acesso ao JiraJIRA_EMAIL | O endereço de e-mail que você usa para entrar no Jira. Insira-o em Conectar Jira junto com o token de acesso. | Empty |
Token de acesso do JiraJIRA_API_TOKEN | Um código semelhante a uma senha que permite ao Studio usar sua conta Jira. Crie-o na sua conta Atlassian em Segurança → Tokens de API; ele fica neste computador e nunca é compartilhado. | Vazio. Salvo apenas neste computador. |
Projeto do Jira para chamados de falhasJIRA_PROJECT_KEY | O código curto antes de cada número de chamado no projeto, como QA em QA-123. Preenchido quando você seleciona o projeto em Conectar Jira. | QA |
Status no Jira quando o teste passaJIRA_DONE_TRANSITION | O status para o qual um Bug passa quando seu teste volta a passar em todos os navegadores, como Concluído. Se estiver vazio, usa Concluído; se esse status não existir no seu Jira, o Studio apenas adiciona um comentário. | Concluído |
Anexar gravação completa aos chamadosNEXUS_ISSUE_ATTACH_TRACE | Adiciona a gravação técnica e o registro bruto aos chamados do Jira e do Azure. Desativado por padrão, pois eles podem conter cookies e senhas digitadas que qualquer pessoa do projeto pode acessar. | false |
Busca no Jira por falhas não detectadasNEXUS_JIRA_ESCAPED_JQL | Um filtro de pesquisa do Jira que encontra bugs que chegaram à produção, como status = Done AND labels = production. Se ficar vazio, as métricas de bugs não detectados exibem "não configurado". | Empty |
Criar itens de trabalho no Azure para falhasAZURE_BOARDS_ENABLED | Cria um item de trabalho (um chamado) no Azure Boards quando um teste falha e o atualiza nas execuções seguintes. Ativado automaticamente ao salvar Conectar Azure DevOps. | false |
Endereço da organização no Azure DevOpsAZURE_DEVOPS_ORG_URL | O endereço web da sua organização, como https://dev.azure.com/yourcompany. Preenchido automaticamente quando você cola qualquer link do Azure DevOps em Conectar. | Empty |
Nome do projeto no Azure DevOpsAZURE_DEVOPS_PROJECT | O projeto da sua organização que recebe os itens de trabalho e executa o pipeline. Preenchido quando você o seleciona em Conectar Azure DevOps. | Empty |
Token de acesso do Azure DevOpsAZURE_DEVOPS_PAT | Um código semelhante a uma senha (token de acesso pessoal) para sua conta Azure, criado em Configurações do usuário → Tokens de acesso pessoal. Ele fica neste computador e nunca é compartilhado. | Vazio. Salvo apenas neste computador. |
Tipo de chamado do Azure para falhasAZURE_BOARDS_WORK_ITEM_TYPE | O tipo de item de trabalho criado para uma falha, como Bug. Ele deve existir no seu projeto; se estiver vazio, usa Bug. | Bug |
Estado no Azure quando o teste passaAZURE_BOARDS_DONE_STATE | O estado para o qual um item de trabalho passa quando seu teste volta a passar, como Resolvido. Se estiver vazio, usa Resolvido; se o projeto não aceitar esse estado, o Studio apenas adiciona um comentário. | Resolved |
Pipeline do Azure para executar em CIAZURE_PIPELINE_ID | O número do pipeline do Azure iniciado por Executar em CI. Abra o pipeline no Azure DevOps e copie o número após definitionId= na barra de endereços. | Empty |
Enviar alertas para o SlackSLACK_ENABLED | Envia falhas de testes, resumos e outros alertas para o Slack. Desativado por padrão; é ativado ao salvar o Slack Connect, que pode enviar uma mensagem de teste. | false |
Canal do Slack para alertasSLACK_WEBHOOK_URL | Um link privado do Slack que permite ao Studio publicar em um canal. Crie-o em Slack → Seus aplicativos → Webhooks de entrada; ele fica neste computador e nunca é compartilhado. | Vazio. Salvo apenas neste computador. |
Enviar alertas para o Microsoft TeamsTEAMS_ENABLED | Publica falhas de testes e resumos em um canal do Teams. Desativado por padrão: salvar o webhook do Teams ativa o recurso, que pode enviar uma mensagem de teste. | false |
Canal do Teams para alertasTEAMS_WEBHOOK_URL | Um link privado (um webhook) que permite ao Studio publicar em um canal do Teams. Crie-o no menu ··· do canal → Fluxos de trabalho → “Publicar em um canal quando uma solicitação de webhook for recebida”. | Vazio. Salvo apenas neste computador. |
Criar issues no GitHub para falhasGITHUB_ISSUES_ENABLED | Abre um problema no GitHub quando um teste falha, adiciona um comentário quando ele falha novamente e fecha o problema quando o teste passa. É ativado ao salvar o cartão do GitHub Issues. | false |
Token de acesso do GitHubGITHUB_ISSUES_TOKEN | Um código semelhante a uma senha (token) que permite ao Studio abrir problemas em um repositório. Crie-o no GitHub com Issues definido como Leitura e gravação; ele fica neste computador. | Vazio. Salvo apenas neste computador. |
Repositório do GitHub para issuesGITHUB_ISSUES_REPO | O repositório que recebe os problemas, no formato proprietário/repositório, como acme/web. Selecione-o na lista do cartão do GitHub Issues. | Empty |
Enviar chamados para seu próprio sistemaTICKETS_HOOK_ENABLED | Envia cada teste com falha para um endereço da web seu, como uma mensagem assinada, para que sua própria ferramenta possa abrir o chamado. Desativado por padrão; também exige um destino “webhook” (uma entrada na configuração de chamados). | false |
Endereço do seu sistema de chamadosTICKETS_WEBHOOK_URL | O endereço https que recebe cada chamado como uma mensagem. Ele fica neste computador e não é exibido novamente após ser salvo. | Vazio. Salvo apenas neste computador. |
Senha de assinatura dos seus chamadosTICKETS_WEBHOOK_SECRET | Uma senha com pelo menos 16 caracteres. Cada mensagem é assinada com ela para que seu sistema possa verificar se a mensagem realmente veio daqui. | Vazio. Salvo apenas neste computador. |
Token do GitHub para CI/CDGITHUB_CI_TOKEN | Um código semelhante a uma senha (token) que salva seus segredos de CI no GitHub sem o programa gh. Conceda a permissão Secrets: Read and write; se ficar vazio, usa o gh. | Vazio. Salvo apenas neste computador. |
Execução & Outros
Chaves de terceiros para ferramentas externas.
| Configuração | O que faz | Padrão |
|---|---|---|
Chave de API do ApolloAPOLLO_API_KEY | Chave do serviço de contatos de vendas Apollo.io, criada nas configurações da sua conta Apollo, em API. Nenhum recurso do Nexus Studio a utiliza, então deixe em branco, a menos que suas próprias ferramentas a leiam. | Vazio. Salvo apenas neste computador. |
Orientação do celularNEXUS_EMU_ORIENTATION | Retrato ou paisagem para cada execução no celular. Deixe em branco para manter o celular na vertical, como vem por padrão. | Empty |
Localização do celularNEXUS_EMU_GEO | Onde o celular informa estar, no formato latitude,longitude (por exemplo, 4.711,-74.0721). A página recebe essa localização sem pedir permissão. | Empty |
Idioma do celularNEXUS_EMU_LOCALE | O idioma e a região informados pelo celular, como es-CO ou pt-BR. Deixe em branco para manter os do próprio celular. | Empty |
Fuso horário do celularNEXUS_EMU_TIMEZONE | O fuso horário informado pelo celular, como America/Bogota. Deixe em branco para manter o deste computador. | Empty |
Modo escuro do celularNEXUS_EMU_COLOR_SCHEME | light, dark ou no-preference: a configuração de cores do celular que a página identifica. | Empty |
Movimento reduzido no celularNEXUS_EMU_REDUCED_MOTION | reduce faz a página identificar um celular configurado para exibir menos animações; no-preference desativa isso. | Empty |
Abrir ocorrências no Linear em caso de falhasLINEAR_ENABLED | Abre uma ocorrência no Linear por teste com falha, adiciona um comentário quando ele falha novamente e fecha a ocorrência quando ele passa. Desativado por padrão; também exige um destino “linear” nas configurações de chamados. | false |
Chave de API do LinearLINEAR_API_KEY | Uma chave de API pessoal do Linear (Configurações → Segurança & acesso → Chaves de API pessoais). Ela fica neste computador e não é exibida novamente após ser salva. | Vazio. Salvo apenas neste computador. |
Equipe do LinearLINEAR_TEAM_ID | O ID da equipe do Linear que recebe as ocorrências. Um destino pode indicar outra equipe usando sua própria configuração específica. | Empty |
Abrir ocorrências no GitLab em caso de falhasGITLAB_ISSUES_ENABLED | Abre uma ocorrência no GitLab por teste com falha, adiciona uma nota quando ele falha novamente e fecha a ocorrência quando ele passa. Desativado por padrão; também exige um destino “gitlab” nas configurações de chamados. | false |
Token do GitLab para ocorrênciasGITLAB_ISSUES_TOKEN | Um token de acesso do GitLab com o escopo api. Ele só é enviado por https ao seu GitLab, fica neste computador e não é exibido novamente após ser salvo. | Vazio. Salvo apenas neste computador. |
Projeto do GitLab para ocorrênciasGITLAB_ISSUES_PROJECT | O projeto que recebe as ocorrências: seu número ou seu caminho, como group/name. O endereço do GitLab é o mesmo usado pelo CI/CD (gitlab.com por padrão). | Empty |
Acionar o plantão no PagerDutyPAGERDUTY_ENABLED | Dispara um alerta no PagerDuty por teste com falha e o resolve quando o teste volta a passar. Desativado por padrão; também exige um destino “pagerduty” nas configurações de chamados. | false |
Chave de integração do PagerDutyPAGERDUTY_ROUTING_KEY | A chave de integração da Events API v2 do serviço do PagerDuty que receberá os alertas. Ela fica neste computador e não é exibida novamente após ser salva. | Vazio. Salvo apenas neste computador. |
Alertar o plantão no OpsgenieOPSGENIE_ENABLED | Abre um alerta no Opsgenie por teste com falha, adiciona uma nota quando ele falha novamente e fecha o alerta quando ele passa. Desativado por padrão; também exige um destino “opsgenie”. | false |
Chave de API do OpsgenieOPSGENIE_API_KEY | Uma chave de API do Opsgenie com permissão para criar e fechar alertas. Ela fica neste computador e não é exibida novamente após ser salva. | Vazio. Salvo apenas neste computador. |
Região do OpsgenieOPSGENIE_API_URL | https://api.opsgenie.com, ou https://api.eu.opsgenie.com se sua conta do Opsgenie estiver na UE. | https://api.opsgenie.com |
Enviar resultados ao TestRailTESTRAIL_ENABLED | Ao final de cada execução, cria uma execução no TestRail com todos os testes que identificam seu caso (um comentário // nexus:testrail C123) e publica o resultado de aprovação ou falha. Desativado por padrão. | false |
Endereço do TestRailTESTRAIL_URL | Seu site do TestRail, como https://yourcompany.testrail.io. Apenas https é aceito. | Empty |
Usuário do TestRailTESTRAIL_USER | O e-mail da conta do TestRail que publica os resultados. | Empty |
Chave de API do TestRailTESTRAIL_API_KEY | Uma chave de API dessa conta do TestRail (Minhas configurações → Chaves de API). Ela fica neste computador e nunca mais é exibida depois de salva. | Vazio. Salvo apenas neste computador. |
Projeto do TestRailTESTRAIL_PROJECT_ID | O número do projeto do TestRail ao qual as execuções são enviadas (o P no endereço, sem o P). | Empty |