Instalando o Axe DevTools Linter Connector como um pacote npm

Este artigo descreve como baixar e instalar o Axe DevTools Connector usando o Agora como um repositório de pacotes npm. Ao fazer isso, você pode aproveitar a infraestrutura fornecida pelo Node.js e npm para baixar, versionar e atualizar seu binário do Axe DevTools Linter Connector, evitando os passos manuais necessários ao baixar o Conector diretamente via a página de downloads .

O que é o Agora?

O Agora é o repositório da Deque (hospedado pela JFrog como uma fábrica de artefatos ou artifactory), que armazena com segurança artefatos binários (pacotes, bibliotecas e executáveis) e requer uma conta para acesso. O Agora hospeda o Axe Linter Connector (tanto o pacote npm quanto o executável disponível para download manual).

Crie um Token de Identidade do Agora

O primeiro passo é criar um token de identidade que o npm usará para autenticar sua sessão no Agora. Tokens de identidade do Agora expiram após um ano, então devem ser recriados anualmente.

1. Visite sua página de perfil no Agora para obter um token de identidade. (Se você não estiver logado no Agora, poderá ser redirecionado para uma página diferente do que a de perfil após fazer login. Clique no mesmo link uma segunda vez após fazer login para ir para sua página de perfil. Ou clique no botão à direita do botão de ajuda no canto superior direito, e então clique em **Editar Perfil**.)
2. Clique em **Gerar um Token de Identidade**.
3. Adicione uma descrição para ajudar a identificar o token no futuro. (Opcional)
4. Clique no ícone de copiar para copiar o token de identidade para sua área de transferência. (Você pode querer salvar este token de identidade em um gerenciador de senhas porque não poderá recuperá-lo novamente.)

Configure seu .npmrc

Agora que você tem um token de identidade do Agora, você pode configurar seu .npmrc arquivo para habilitar o uso da infraestrutura npm para instalar o Conector.

1. Visite o site Configurando o Acesso a Pacotes Agora para criar a configuração a ser colada no seu .npmrc arquivo. Note que nenhuma informação nesta página é armazenada ou transmitida.
2. Adicione seu endereço de e-mail (deve ser o mesmo com o qual você está registrado no site do Agora).
3. Cole seu token de identidade na caixa de texto correspondente.
4. Clique em **Gerar Configuração** para criar uma configuração e clique no ícone de copiar.
5. Cole as linhas copiadas no seu .npmrc arquivo. O caminho para o arquivo é especificado no site para Linux, macOS e Windows.

Após seguir estes passos, você poderá usar o pacote npm do Axe DevTools Linter Connector.

Exemplo .npmrc

A seguir, um exemplo das linhas que precisam ser adicionadas ao seu .npmrc configuração:

@axe-devtools:registry=https://agora.dequecloud.com/artifactory/api/npm/devtools-npm/
//agora.dequecloud.com/artifactory/api/npm/devtools-npm/:_auth="am9obmRvZUBleGFtcGxlLmNvbTpUaGlzIGlzbid0IGEgdmFsaWQgaWRlbnRpdHkgdG9rZW4K"
//agora.dequecloud.com/artifactory/api/npm/devtools-npm/:email=johndoe@example.com
//agora.dequecloud.com/artifactory/api/npm/devtools-npm/:always-auth=true

O valor incluído com _auth é a codificação base64 de <email>:<identity-token>.

//agora.dequecloud.com/artifactory/api/npm/devtools-npm/:_authToken="VGhpcyBpc24ndCBhIHZhbGlkIGlkZW50aXR5IHRva2VuCg=="

Instalação e Uso

Você pode instalar a versão mais recente do Conector Axe DevTools com:

npm install @axe-devtools/axe-linter-connector -g

Este comando instala o Conector globalmente. Verifique a instalação usando a opção --version :

axe-linter-connector --version

Próximos Passos

• Consulte a documentação para o Conector Axe Linter.
• (Documentação externa JFrog) Conecte Seu Cliente npm ao Artifactory para uma discussão detalhada de como configurar seu .npmrc manualmente.