Instalar Axe DevTools para Web para Playwright 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 escalável para instalação do que baixar o Axe DevTools diretamente, 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 sobre Instalação 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 do Agora. Além disso, você deve ter um projeto web existente baseado em NodeJS para instalar o Axe DevTools. Dependendo da configuração do seu ambiente de teste, sua biblioteca de teste 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 aplicativo web 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 ao lado do botão de ajuda. A partir daí, você pode criar e copiar um 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 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 email de login do Agora, e substitua pelo Token de Identidade que você copiou na etapa anterior. O retorno do comando deve 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, 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 seu arquivo ~/.yarnrc.yml para edição. Adicione primeiro 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 puder 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 que seria gerado com o comando curl.

Instalando

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

npm install @axe-devtools/playwright

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

npm install playwright

Próximos Passos

Uma vez que o Axe DevTools tenha sido instalado com sucesso em seu ambiente, leia o guia em importação e inicialização.

Se você tiver problemas ao instalar o Axe DevTools, entre em contato diretamente com seu representante Deque, pergunte-nos via nossa mesa de apoio, ou nos envie um email. Ficaremos felizes em ajudá-lo a começar.