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 registro de pacotes npm. Fazer isso permite que você aproveite a infraestrutura fornecida pelo Node.js e npm para baixar, versionar e atualizar seu binário do Axe DevTools Linter Connector, evitando as etapas manuais exigidas quando você baixa o Connector diretamente através da página página de downloads.

O que é o Agora?

Agora é o repositório da Deque (hospedado pelo JFrog como uma fábrica de artefatos ou artifactory), que armazena de forma segura 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 que pode ser baixado manualmente).

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 seu página de perfil do Agora para obter um token de identidade. (Se você não estiver logado no Agora, poderá ser redirecionado para uma página de destino diferente da sua página de perfil após fazer login. Clique em mesmo link uma segunda vez depois de 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, em seguida, 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, pode configurar seu arquivo .npmrc para habilitar o uso da infraestrutura npm para instalar o Connector.

1. Visite o site Configurando o Acesso a Pacotes Agora para criar a configuração para colar em seu arquivo .npmrc. Observe que nenhuma das informações 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 em seu arquivo .npmrc. 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 à sua configuração .npmrc:

@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 Connector 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 do JFrog) Conecte Seu Cliente npm ao Artifactory para uma discussão detalhada sobre como configurar seu .npmrc manualmente.