Configuración de Axe DevTools para Web CLI

Las banderas descritas en este artículo están disponibles para axe <url>, axe spec, y axe bulk-spec. Cuando configura una de estas banderas, el valor se guarda en el archivo de preferencias y se convierte en el valor predeterminado para todas las ejecuciones subsiguientes. Para ver o cambiar las preferencias de manera interactiva, incluyendo restablecer valores que no tienen una bandera correspondiente, use axe config-selenium.

Opciones del Navegador

--accept-untrusted

Indica al navegador que acepte certificados SSL no confiables. Use esto cuando pruebe páginas en servidores de desarrollo local o entornos internos que utilicen certificados autofirmados. Pasar esta bandera guarda acceptUntrustedCertificates: true en el archivo de preferencias. Para restablecerlo a false, ejecute axe config-selenium y responda No cuando se le pregunte, o edite el archivo de preferencias directamente.

axe <url> --accept-untrusted

--browser <name>

Especifica qué navegador usar. El WebDriver correspondiente debe estar instalado y disponible en su $PATH. Los valores válidos son: firefox (predeterminado), chrome, safari, edge, ie.

axe <url> --browser chrome

Si obtiene un error al iniciar el navegador en su primer intento, GeckoDriver (el WebDriver de Firefox) puede no estar instalado. Intente --browser chrome en su lugar, lo cual generalmente funciona sin configuración adicional en la mayoría de los sistemas.

Pasar esta bandera guarda el nombre del navegador en el archivo de preferencias. Todas las ejecuciones subsiguientes, incluidas las ejecuciones sin --browser, usarán el navegador guardado. Para cambiar el navegador guardado, ejecute axe config-selenium y elija un navegador diferente en el indicador, o edite el archivo de preferencias directamente.

--headless

Lanza el navegador en modo invisible (sin ventana visible). El valor predeterminado es false.

axe <url> --headless

--remote-server <url>

Conecta a un servidor WebDriver remoto en lugar de lanzar un navegador local. El servidor debe exponer un endpoint compatible con WebDriver de W3C, como Selenium Grid, BrowserStack o Sauce Labs remoto.

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

--window-size <width,height>

Establece el tamaño de la ventana del navegador en píxeles. Esto también controla el tamaño del viewport en modo invisible, lo cual es útil para probar diseños responsivos.

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

Opciones de Temporización

--page-timeout <ms>

Tiempo máximo en milisegundos (ms) para esperar a que una página se cargue antes de fallar. El valor predeterminado es 60,000 ms (60 segundos). Aumente este valor para páginas de carga lenta o entornos de red con alta latencia.

axe <url> --page-timeout 120000

--post-analyze-pause <ms>

Tiempo en milisegundos para pausar después de completar un análisis antes de pasar a la siguiente acción en un flujo de trabajo. El valor predeterminado es 2,000 ms (2 segundos).

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

--post-get-pause <ms>

Tiempo en milisegundos para pausar después de cargar una página y antes de comenzar el escaneo. El valor predeterminado es 2,000 ms (2 segundos). Aumente este valor si el contenido dinámico necesita más tiempo para renderizarse antes de que comience el escaneo.

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

--post-script-pause <ms>

Tiempo en milisegundos para pausar después de ejecutar una acción del script de flujo de trabajo y antes de continuar con la siguiente acción. El valor predeterminado es 2,000 ms (2 segundos).

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

--script-timeout <ms>

Tiempo máximo en milisegundos para esperar a que un script de flujo de trabajo termine su ejecución. El valor predeterminado es 60,000 ms (60 segundos).

axe spec workflow.yml --script-timeout 120000

Seguimiento de Uso

Axe DevTools CLI incluye el @deque/metrics-library, que envía datos de uso anónimos a Deque. Estos datos incluyen información agregada como recuentos de violaciones, recuentos de reglas y la versión del motor axe-core. No incluye URL, contenido de las páginas ni ninguna información personal identificable.

Un ID distinto es un valor almacenado en el archivo de preferencias que se utiliza para correlacionar eventos a través de múltiples ejecuciones de CLI sin identificar al usuario. Puede cambiar o deshabilitar el seguimiento con las siguientes opciones. Para deshabilitar el seguimiento por completo sin usar el CLI, establezca la variable de entorno AXE_TRACK_USAGE=false.

--enable-tracking <state>

Habilita o deshabilita el envío de datos de uso a la biblioteca de métricas. Pasa true para habilitar o false para deshabilitar.

axe <url> --enable-tracking false

--set-distinct-id <id>

Cambia el ID distintivo utilizado para correlacionar eventos de uso. El ID se guarda en el archivo de preferencias y se utiliza en todas las ejecuciones.

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

--set-tracking-url <url>

Cambia el punto de conexión donde se envían las métricas de uso. Utiliza esto si tu organización redirige la telemetría a través de un proxy interno.

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

axe config-selenium

Usa axe config-selenium para configurar los valores predeterminados de manera interactiva. Se te pedirá que ingreses valores para el navegador, tiempo de espera y otros ajustes. Tus respuestas se guardarán en el archivo de preferencias y se convertirán en los predeterminados para todas las ejecuciones posteriores del 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 ver la configuración guardada actual sin ingresar al mensaje interactivo, usa la --show bandera:

axe config-selenium --show

Archivo de Preferencias

Todos los valores predeterminados configurables se guardan en un archivo JSON en:

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

Un archivo típico se ve así:

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

Puedes editar este archivo directamente como alternativa a usar axe config-selenium o pasar banderas en la línea de comandos. Esto es útil para restablecer valores booleanos como acceptUntrustedCertificates sin ejecutar el mensaje interactivo.