Instalando Axe DevTools para Web CLI

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

Instale o CLI como um executável independente ou como um pacote Node.js.

Not for use with personal data

A CLI do Axe DevTools está disponível em duas formas. Escolha a que se adapta ao seu ambiente:

Requisitos

O Axe DevTools CLI requer um driver de navegador para cada navegador que você deseja usar. O driver deve estar no seu PATH. Mantenha tanto o navegador quanto o driver atualizados.

Navegador Driver
Chrome ChromeDriver
Firefox geckodriver
Safari o safaridriver está embutido no macOS. Talvez você precise executar safaridriver --enable antes de usá-lo.
Microsoft Edge Microsoft Edge WebDriver
Internet Explorer Servidor de Driver IE

Instalar o Executável

Os executáveis não possuem pré-requisitos; Node.js não é necessário.

important

Você precisa de uma conta Deque Agora para acessar a página de downloads. Se você não tiver uma, entre em contato com seu representante da Deque, use nosso suporte técnico, ou nos envie um email.

Baixe o executável apropriado para a sua plataforma a partir do seção CLI na página de downloads:

  • axe-linux (Linux)
  • axe-macos (macOS)
  • axe-win.exe (Windows)

Configuração no Linux

Torne o arquivo executável:

chmod +x axe-linux

Configuração no macOS

Torne o arquivo executável e remova o atributo de quarentena que o macOS adiciona aos arquivos baixados:

chmod +x axe-macos
xattr -d com.apple.quarantine axe-macos

Teste sua instalação

Execute o comando de ajuda no diretório onde você colocou o executável:

  • Linux: ./axe-linux --help
  • macOS: ./axe-macos --help
  • Windows: axe-win --help

Dependendo da configuração da sua conta, pode ser necessário privilégios de administrador.

Torne o CLI disponível globalmente

Para executar axe de qualquer diretório, coloque o executável em um diretório no seu PATH.

note

O restante desta documentação assume que você renomeou o executável para axe (ou axe.exe no Windows) e que ele está disponível globalmente.

Instalar via Node.js

Você precisa ter Node.js instalado. Para verificar, execute node -v no seu terminal.

note

Você precisa de acesso ao registro privado da Deque Systems. Se você ainda não tiver acesso, entre em contato com o suporte técnico da Deque Systems.

Passo 1: Obtenha um Token de Identidade Agora

Agora é o registro npm privado da Deque que hospeda pacotes @axe-devtools. Para acessá-lo, você precisa de um token de identidade.

  1. Visite o seu página de perfil do Agora. (Se você for redirecionado após o login, clique no link uma segunda vez ou clique em Editar Perfil no canto superior direito.)
  2. Clique em Gerar um Token de Identidade.
  3. Opcionalmente, adicione uma descrição para identificar o token mais tarde.
  4. Copie o token para sua área de transferência. Salve-o em um lugar seguro, pois você não poderá recuperá-lo novamente no Agora.
important

Lembre-se de copiar o valor do seu Token de Identidade ao criá-lo, pois esta será sua única oportunidade. Caso contrário, você terá que criar um novo token.

Tokens de Identidade expiram (geralmente após um ano), então você precisará recriar seu token periodicamente.

Passo 2: Configure o seu .npmrc

  1. Visite a ferramenta Configuração de Acesso aos pacotes do Agora. Nenhuma das informações que você digita é armazenada ou transmitida.
  2. Digite seu endereço de e-mail do Agora e o token de identidade.
  3. Clique em Gerar Configuração e copie a saída.
  4. Cole as linhas copiadas no seu arquivo ~/.npmrc (%USERPROFILE%/.npmrc no Windows).

Seu .npmrc deve ficar assim:

@axe-devtools:registry=https://agora.dequecloud.com/artifactory/api/npm/devtools-npm/
//agora.dequecloud.com/artifactory/api/npm/devtools-npm/:_auth="<generated-auth-string>"
//agora.dequecloud.com/artifactory/api/npm/devtools-npm/:email=<your-email@example.com>
//agora.dequecloud.com/artifactory/api/npm/devtools-npm/:always-auth=true

O valor _auth é a codificação base64 de <your-email>:<your-identity-token>.

Passo 3: Instale o pacote

Instale globalmente com npm:

npm install -g @axe-devtools/cli

Ou com Yarn:

yarn global add @axe-devtools/cli

Teste sua instalação

axe --help

Se o texto de ajuda aparecer, o CLI está instalado e pronto para uso.

Is this page helpful?

Help us improve this page

Still need help?