Instale o Axe DevTools para Web no Node.js 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. Este guia aborda a instalação de qualquer um dos pacotes Node.js do Axe DevTools a partir do repositório de artefatos Agora da Deque. Para informações sobre outras maneiras de instalar o Axe DevTools, consulte o guia sobre 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 do Agora. Além disso, é necessário ter um projeto web existente baseado em Node.js para instalar o Axe DevTools. Dependendo da configuração do seu ambiente de teste, sua biblioteca de testes (por exemplo, Cypress, Playwright, Puppeteer, WebdriverIO ou WebDriverJS) 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 Bem-vindo seu-endereço-de-email na barra superior, próximo ao 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, você precisará adicionar suas informações de autenticação do Agora em um arquivo ~/.npmrc. A ferramenta Configurando Acesso aos pacotes do Agora pode gerar este conteúdo .npmrc para você a partir do seu e-mail do Agora e do Token de Identidade. Caso contrário, a maneira mais simples de fazer isso manualmente é 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 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

Uma vez que a autenticação estiver configurada, instale o pacote para sua biblioteca de teste.

JavaScript para Navegadores (@axe-devtools/browser)

npm install @axe-devtools/browser

Uma vez instalado, leia o guia sobre importação e inicialização.

Cypress (@axe-devtools/cypress)

npm install @axe-devtools/cypress

Se ainda não instalou o Cypress em si, você pode instalá-lo com o comando

npm install cypress

Playwright (@axe-devtools/playwright)

npm install @axe-devtools/playwright

Se ainda não instalou o Playwright em si, você pode instalá-lo com o comando

npm install playwright

Uma vez instalado, leia o guia sobre importação e inicialização.

Puppeteer (@axe-devtools/puppeteer)

npm install @axe-devtools/puppeteer

Se ainda não instalou o Puppeteer em si, você pode instalá-lo com o comando

npm install puppeteer

Uma vez instalado, leia o guia sobre importação e inicialização.

WebdriverIO (@axe-devtools/webdriverio)

npm install @axe-devtools/webdriverio

Uma vez instalado, leia o guia sobre importação e inicialização.

WebDriverJS (@axe-devtools/webdriverjs)

npm install @axe-devtools/webdriverjs

Uma vez instalado, leia o guia sobre importação e inicialização.

Próximos Passos

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