Usando o CLI no WSL (Subsistema do 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

Execute o executável Linux do Axe DevTools CLI dentro do WSL no Windows, incluindo com uma janela do navegador visível.

Not for use with personal data

WSL (Subsistema do Windows para Linux) permite que você execute um ambiente Linux, incluindo axe-linux, diretamente em uma máquina Windows. Isso é útil se a sua configuração de teste (por exemplo, scripts Perl ou outras ferramentas exclusivas do Linux) já estiver rodando dentro do WSL e você quiser executar o Axe DevTools CLI juntamente com ela, sem precisar configurar um ambiente Linux separado.

note

Este é um fluxo de trabalho de prova de conceito, não uma configuração oficialmente suportada. Foi verificado que funciona, mas a Deque não garante sua operação em todas as versões do WSL, distribuições Linux ou atualizações do Windows. Avalie seus próprios requisitos de segurança antes de usar isso em um ambiente de cliente ou de produção.

Pré-requisitos

Windows com WSL habilitado, executando uma distribuição Ubuntu. Outras distribuições Linux podem funcionar, mas não foram verificadas.
Windows Terminal (ou outro aplicativo de terminal) para acessar seu ambiente Ubuntu no WSL.
Suporte do WSL para aplicações GUI, se você desejar executar o navegador em modo não headless. Isso foi incorporado ao WSL desde 2021, então uma versão atual do Windows 10 ou Windows 11 é suficiente.

Instalar Google Chrome e ChromeDriver no WSL

Dentro do seu terminal Ubuntu no WSL, atualize os pacotes e, em seguida, instale o 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

Verifique a versão instalada:

google-chrome --version

Baixe a versão correspondente do ChromeDriver a partir do Painel de disponibilidade do Chrome para Testes. Por exemplo:

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

Verifique a versão do ChromeDriver:

chromedriver --version

Instalar Axe DevTools CLI

Baixe axe-linux e configure-a conforme descrito em Instalar o Executável. Dentro do seu terminal Ubuntu no WSL:

chmod +x axe-linux

axe-linux --version

Executar uma análise

Modo headless

Configure o CLI, escolhendo chrome como o navegador e respondendo Sim quando solicitado a iniciar o navegador em modo headless:

axe-linux config-selenium

Depois execute uma análise:

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

Veja Configurar para o que cada config-selenium comando controla.

Modo não headless

Execute axe-linux config-selenium novamente e responda Não quando solicitado a iniciar o navegador em modo headless, então execute a mesma análise:

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

Com o modo headless desativado, o suporte GUI do WSL abre uma janela do Chrome visível enquanto axe-linux é executado:

Executar um arquivo spec

Você também pode executar um arquivo spec da mesma forma que faria fora do WSL:

axe-linux spec deque-workflow.yaml