Instalar Axe DevTools para Web para Puppeteer do Agora da Deque

Para clientes que não possuem um repositório interno de artefatos e desejam uma solução mais sustentável e escalável para instalação do que baixar diretamente o Axe DevTools, a Deque disponibiliza seu próprio repositório de artefatos para clientes selecionados. Para informações sobre outras maneiras de instalar o Axe DevTools, consulte os guias em Instalando a partir de um Pacote ou Instalando a partir do seu Repositório de Artefatos.

Pré-requisitos

Para instalar o Axe DevTools a partir do Agora, você deve ter credenciais de login no Agora. Além disso, é necessário já ter um projeto web baseado em NodeJS para instalar o Axe DevTools. Dependendo da configuração do seu ambiente de testes, sua biblioteca de testes pode ser necessária como uma dependência adicional.

Criando um Token de Identidade

A maneira mais simples de criar um Token de Identidade é através do webapp Agora. Após fazer login, você pode criar um Token de Identidade clicando no botão rotulado Bem-vindo seu-endereço-de-email na barra superior ao lado do botão de ajuda. A partir daí, você pode criar e copiar seu Token de Identidade.

Adicionando Autenticação

Para acessar os pacotes Axe DevTools através do NPM ou Yarn, será necessário adicionar suas informações de autenticação do Agora a um arquivo ~/.npmrc. A maneira mais simples de fazer isso é com um comando curl.

curl -u"<your-email>":<your-identity-token> "https://agora.dequecloud.com/artifactory/api/npm/auth"

Ao executar este comando, substitua pelo seu email de login no Agora e substitua pelo Token de Identidade que você copiou na etapa anterior. O retorno do comando deve se parecer com isto:

_auth = <generated-auth-string>
always-auth = true
email = <your-email>

Configurando seu arquivo .npmrc (yarn/npm)

Abra seu arquivo ~/.npmrc para edição. Adicione primeiro as informações do registro e, em seguida, adicione o resultado do comando curl. O produto final deve se parecer com isto:

@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@email.com>
//agora.dequecloud.com/artifactory/api/npm/devtools-npm/:always-auth=true

Configurando seu arquivo .yarnrc.yml (yarn moderno)

Abra seu arquivo ~/.yarnrc.yml para edição. Adicione primeiro as informações do registro e, em seguida, adicione o resultado do comando curl. O produto final deve se parecer com isto:

npmScopes:
  axe-devtools:
      npmRegistries: 'https://agora.dequecloud.com/artifactory/api/npm/dequelabs/':
      npmAuthIdent: <generated-auth-string>
      npmRegistryServer: 'https://agora.dequecloud.com/artifactory/api/npm/dequelabs/'
      npmAlwaysAuth: true

Se você não puder executar comandos curl, pode gerar sua string de autenticação codificada em base-64 <your-email>:<your-identity-token> e adicioná-la ao arquivo ~/.npmrc da mesma forma como se fosse gerada com o comando curl.

Instalação

Para instalar o Axe DevTools Puppeteer em seu projeto, execute este comando:

npm install @axe-devtools/puppeteer

Se você ainda não instalou o próprio Puppeteer, pode instalá-lo com o comando

npm install puppeteer

Próximas Etapas

Depois que o Axe DevTools tiver sido instalado com sucesso em seu ambiente, leia o guia em importando e inicializando.

Se você tiver problemas para instalar o Axe DevTools, contate seu representante Deque diretamente, pergunte-nos através da nossa central de suporte, ou envie-nos um email. Ficaremos felizes em ajudá-lo a começar.