Configurando o Axe DevTools para Web CLI

As opções descritas neste artigo estão disponíveis para axe <url>, axe spece axe bulk-spec. Quando você define uma dessas opções, o valor é salvo no arquivo de preferências e se torna o padrão para todas as execuções subsequentes. Para visualizar ou alterar as preferências interativamente, incluindo redefinir valores que não possuem uma opção correspondente, use axe config-selenium.

Opções do Navegador

--accept-untrusted

Instrui o navegador a aceitar certificados SSL não confiáveis. Use isso ao testar páginas em servidores de desenvolvimento local ou ambientes internos que utilizam certificados autoassinados. Passar esta opção salva acceptUntrustedCertificates: true no arquivo de preferências. Para redefini-lo para false, execute axe config-selenium e responda Não quando solicitado, ou edite o arquivo de preferências diretamente.

axe <url> --accept-untrusted

--browser <name>

Especifica qual navegador usar. O WebDriver correspondente deve estar instalado e disponível no seu $PATH. Valores válidos são: firefox (padrão), chrome, safari, edge, ie.

axe <url> --browser chrome

Se você receber um erro de inicialização do navegador na sua primeira execução, o GeckoDriver (WebDriver do Firefox) pode não estar instalado. Tente --browser chrome em vez disso, o que geralmente funciona sem configuração adicional na maioria dos sistemas.

Passar esta opção salva o nome do navegador no arquivo de preferências. Todas as execuções subsequentes, incluindo execuções sem --browser, usarão o navegador salvo. Para alterar o navegador salvo, execute axe config-selenium e escolha um navegador diferente no prompt, ou edite o arquivo de preferências diretamente.

--headless

Inicia o navegador no modo headless (sem janela visível). O padrão é false.

axe <url> --headless

--remote-server <url>

Conecta-se a um servidor WebDriver remoto em vez de iniciar um navegador local. O servidor deve expor um endpoint compatível com W3C WebDriver, como um Selenium Grid, BrowserStack ou um remoto do Sauce Labs.

axe <url> --remote-server https://hub.browserstack.com/wd/hub

--window-size <width,height>

Define o tamanho da janela do navegador em pixels. Isso também controla o tamanho da viewport no modo headless, tornando-o útil para testar layouts responsivos.

axe <url> --window-size 1280,900

Opções de Tempo

--page-timeout <ms>

Tempo máximo em milissegundos (ms) para esperar o carregamento de uma página antes de falhar. O padrão é 60.000 ms (60 segundos). Aumente isso para páginas de carregamento lento ou ambientes de rede com alta latência.

axe <url> --page-timeout 120000

--post-analyze-pause <ms>

Tempo em milissegundos para pausar após completar uma análise antes de passar para a próxima ação em um fluxo de trabalho. O padrão é 2.000 ms (2 segundos).

axe spec workflow.yml --post-analyze-pause 5000

--post-get-pause <ms>

Tempo em milissegundos para pausar após o carregamento de uma página e antes de iniciar a varredura. O padrão é 2.000 ms (2 segundos). Aumente isso se o conteúdo dinâmico precisar de mais tempo para renderizar antes que a varredura comece.

axe <url> --post-get-pause 5000

--post-script-pause <ms>

Tempo em milissegundos para pausar após executar uma ação de script de fluxo de trabalho e antes de continuar para a próxima ação. O padrão é 2.000 ms (2 segundos).

axe spec workflow.yml --post-script-pause 5000

--script-timeout <ms>

Tempo máximo em milissegundos para esperar a execução de um script de fluxo de trabalho. O padrão é 60.000 ms (60 segundos).

axe spec workflow.yml --script-timeout 120000

Rastreamento de Uso

O Axe DevTools CLI inclui o @deque/metrics-library, que envia dados de uso anônimos para a Deque. Esses dados incluem informações agregadas, como contagem de violações, contagem de regras e versão do motor axe-core. Não inclui URLs, conteúdo de página ou qualquer informação pessoal identificável.

Um ID distinto é um valor armazenado no arquivo de preferências usado para correlacionar eventos em várias execuções do CLI sem identificar o usuário. Você pode alterar ou desabilitar o rastreamento com as opções abaixo. Para desativar o rastreamento completamente sem usar o CLI, defina a variável de ambiente AXE_TRACK_USAGE=false.

--enable-tracking <state>

Habilita ou desabilita o envio de dados de uso para a biblioteca de métricas. Passe true para habilitar ou false para desabilitar.

axe <url> --enable-tracking false

--set-distinct-id <id>

Altera o ID distinto usado para correlacionar eventos de uso. O ID é armazenado no arquivo de preferências e usado em várias execuções.

axe <url> --set-distinct-id my-team-id

--set-tracking-url <url>

Altera o endpoint onde as métricas de uso são enviadas. Use isso se sua organização direcionar a telemetria através de um proxy interno.

axe <url> --set-tracking-url https://metrics.example.com/collect

axe config-selenium

Use axe config-selenium para configurar os valores padrão interativamente. Você será solicitado a inserir valores para navegador, tempo limite e outras configurações. Suas respostas são salvas no arquivo de preferências e se tornam os padrões para todas as execuções subsequentes do CLI.

$ axe config-selenium
? Choose browser for running automated tests: (Use arrow keys)
? Choose browser for running automated tests: chrome
? Enter a value for pageLoadTimeout: 60000
? Enter a value for setScriptTimeout: 60000
? Accept untrusted ssl certs: Yes
? Enter a value for postGetPause: 2000
? Enter a value for postScriptPause: 2000
? Enter a value for postAnalysisPause: 2000
? Launch browser in headless mode: No

Results saved to ~/.config/preferences/com.deque.axe.devtools.cli.pref

Para visualizar as configurações salvas atuais sem entrar no prompt interativo, use o --show flag:

axe config-selenium --show

Arquivo de Preferências

Todos os valores padrão configuráveis são armazenados em um arquivo JSON em:

~/.config/preferences/com.deque.axe.devtools.cli.pref

Um arquivo típico se parece com este:

{
  "selenium": {
    "acceptUntrustedCertificates": false,
    "browser": "firefox",
    "headless": false,
    "pageLoadTimeout": 60000,
    "postAnalysisPause": 2000,
    "postGetPause": 2000,
    "postScriptPause": 2000,
    "setScriptTimeout": 60000
  }
}

Você pode editar este arquivo diretamente como uma alternativa ao uso de axe config-selenium ou passar flags na linha de comando. Isso é útil para redefinir valores booleanos como acceptUntrustedCertificates sem executar o prompt interativo.