Instale Axe DevTools para Web para WebdriverIO a partir do Agora da Deque

Para clientes que não possuem um repositório de artefatos interno e desejam uma solução mais sustentável e escaloná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 formas de instalar Axe DevTools, veja os guias sobre Instalando de um Pacote ou Instalando do seu Repositório de Artefatos.

Pré-requisitos

Para instalar o Axe DevTools a partir do Agora, é necessário ter credenciais de login no Agora. Além disso, você deve ter um projeto web baseado em NodeJS para instalar o Axe DevTools, bem como o WebdriverIO. 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 é fazendo login no webapp do Agora. Uma vez conectado, 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 clicar em Gerar um Token de Identidade e seguir os passos para criar e copiar seu Token de Identidade.

Adicionando Autenticação

Para acessar os pacotes Axe DevTools através do NPM ou Yarn, você precisará adicionar suas informações de autenticação do Agora em 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 e-mail de login do 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 a saída 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 a saída 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 conseguir executar comandos curl, pode gerar sua string de autenticação codificando <your-email>:<your-identity-token> em base-64 e adicionando o produto ao arquivo ~/.npmrc da mesma forma como se fosse gerado com o comando curl.

Instalando

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

npm install @axe-devtools/webdriverio

Próximos Passos

Uma vez que o Axe DevTools tenha sido instalado com sucesso no seu ambiente, leia o guia sobre importando e inicializando.

Se você tiver problemas para instalar o Axe DevTools, entre em contato diretamente com seu representante da Deque, pergunte-nos através do nosso suporte técnico, ou envie-nos um e-mail. Ficaremos felizes em ajudá-lo a começar.