Uso de la CLI en WSL (Subsistema de Windows para Linux)

This page is not available in the language you requested. You have been redirected to the English version of the page.

Link to this page copied to clipboard

Ejecute el ejecutable de Linux de Axe DevTools CLI dentro de WSL en Windows, incluyendo una ventana de navegador visible.

Not for use with personal data

WSL (Subsistema de Windows para Linux) te permite ejecutar un entorno Linux, incluyendo axe-linux, directamente en una máquina con Windows. Esto es útil si tu configuración de pruebas (por ejemplo, scripts de Perl u otras herramientas exclusivas de Linux) ya corre dentro de WSL y deseas ejecutar Axe DevTools CLI junto con ello, sin tener que configurar un entorno Linux aparte.

note

Este es un flujo de trabajo de prueba de concepto, no una configuración oficialmente soportada. Se ha verificado que funciona, pero Deque no lo garantiza en todas las versiones de WSL, distribuciones de Linux o actualizaciones de Windows. Evalúa tus propios requisitos de seguridad antes de usar esto en un entorno de cliente o de producción.

Requisitos previos

Windows con WSL habilitado, ejecutando una distribución de Ubuntu. Otras distribuciones de Linux pueden funcionar pero no se han verificado.
Terminal de Windows (u otra aplicación de terminal) para acceder a tu entorno Ubuntu en WSL.
Soporte de WSL para aplicaciones GUI, si deseas ejecutar el navegador en modo no cabezal. Esto se ha incorporado en WSL desde 2021, por lo que una versión actual de Windows 10 o Windows 11 es suficiente.

Instalar Google Chrome y ChromeDriver en WSL

Dentro de tu terminal Ubuntu en WSL, actualiza los paquetes y luego instala Google Chrome:

sudo apt update && sudo apt -y upgrade

wget https://dl.google.com/linux/direct/google-chrome-stable_current_amd64.deb

sudo apt -y install ./google-chrome-stable_current_amd64.deb

Verifica la versión instalada:

google-chrome --version

Descarga la versión correspondiente de ChromeDriver desde el Tablero de disponibilidad de Chrome para Testing. Por ejemplo:

wget https://storage.googleapis.com/chrome-for-testing-public/129.0.6668.58/linux64/chromedriver-linux64.zip

unzip chromedriver-linux64.zip

sudo cp chromedriver-linux64/chromedriver /usr/local/bin

sudo chmod 775 /usr/local/bin/chromedriver

Verifica la versión de ChromeDriver:

chromedriver --version

Instalar Axe DevTools CLI

Descarga axe-linux y configúralo como se describe en Instalar el ejecutable. Dentro de tu terminal Ubuntu en WSL:

chmod +x axe-linux

axe-linux --version

Ejecutar un análisis

Modo cabezal

Configura la CLI eligiendo chrome como el navegador y responde Sí cuando se te pida lanzar el navegador en modo cabezal:

axe-linux config-selenium

Luego ejecuta un análisis:

axe-linux https://www.deque.com

Consulta Configurar para saber qué controla cada config-selenium de las solicitudes.

Modo no cabezal

Ejecuta axe-linux config-selenium nuevamente y responde No cuando se te pida lanzar el navegador en modo cabezal, luego ejecuta el mismo análisis:

axe-linux https://www.deque.com

Con el modo cabezal desactivado, el soporte GUI de WSL abre una ventana visible de Chrome mientras axe-linux se ejecuta:

Ejecutar un archivo de especificaciones

También puedes ejecutar un archivo de especificaciones de la misma manera que lo harías fuera de WSL:

axe-linux spec deque-workflow.yaml