Instalar Axe DevTools para Web para WebDriverJS 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, veja o guia sobre instalando a partir do seu Repositório de Artefatos ou baixando um projeto de demonstração.

Pré-requisitos

Para instalar o Axe DevTools a partir do Agora, você deve ter credenciais de login no Agora. Além disso, deve ter um projeto web baseado em NodeJS existente para instalar o Axe DevTools dentro dele, assim como o WebDriverJS. Dependendo da configuração do seu ambiente de teste, sua biblioteca de teste pode ser necessária como 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 gerar 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, clicando em Gerar um Token de Identidade, seguindo os passos para criar um Token de Identidade, e copiando seu Token de Identidade.

Adicionando Autenticação

Para acessar os pacotes do Axe DevTools através do NPM ou Yarn, você precisará 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 por seu e-mail de login do Agora e substitua pelo Token de Identidade que você copiou na etapa anterior. O retorno do comando deve ser assim:

_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 a informação do registro e, em seguida, adicione o resultado do comando curl. O produto final deve ser 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@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 a informação do registro e, em seguida, adicione o resultado do comando curl. O produto final deve ser assim:

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 em base-64 <your-email>:<your-identity-token> e adicionando o produto ao arquivo ~/.npmrc da mesma forma como se fosse gerado com o comando curl.

Instalando

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

npm install @axe-devtools/webdriverjs

Próximos Passos

Uma vez que o Axe DevTools tenha sido instalado com sucesso em 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 via nosso suporte técnico, ou envie-nos um e-mail. Ficaremos felizes em ajudá-lo a começar.