Instalar Axe DevTools para Web para JavaScript de Navegador a partir 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 formas de instalar o Axe DevTools, consulte o guia sobre Instalando do seu Repositório de Artefatos.

Pré-requisitos

Para instalar o Axe DevTools a partir do Agora, você deve ter credenciais de login do Agora. Além disso, você deve ter um projeto web baseado em NodeJS já existente para instalar o Axe DevTools. Dependendo da configuração do seu ambiente de teste, 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 do Agora. Uma vez logado, você pode criar um Token de Identidade clicando no botão rotulado como Bem-vindo seu-endereço-de-email na barra superior, ao lado do botão de ajuda. A partir daí, você precisará gerar um Token de Identidade e copiá-lo.

Adicionando Autenticação

Para acessar os pacotes Axe DevTools via 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 pelo seu email 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 o seu arquivo ~/.npmrc para edição. Primeiro, adicione as informações do registro, depois 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 o seu arquivo ~/.yarnrc.yml para edição. Primeiro, adicione as informações do registro, depois 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 conseguir executar comandos curl, pode gerar sua string de autenticação codificando-a em base-64 <your-email>:<your-identity-token> e adicionando o produto ao arquivo ~/.npmrc da mesma forma que se fosse gerado com o comando curl.

Instalando

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

npm install @axe-devtools/browser

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 ao instalar o Axe DevTools, contate diretamente seu representante Deque, pergunte-nos através da nossa mesa de suporte, ou envie-nos um email. Ficaremos felizes em ajudá-lo a começar.