Het installeren van de Axe DevTools Linter Connector als een npm-pakket

Dit artikel beschrijft hoe je de Axe DevTools Connector kunt downloaden en installeren met Agora als een npm-pakkettenregister. Dit stelt je in staat om te profiteren van de infrastructuur die door Node.js wordt geboden en npm om je Axe DevTools Linter Connector-binary te downloaden, te versieën en bij te werken, zonder de handmatige stappen die nodig zijn wanneer je de Connector direct via de downloads pagina downloadt.

Wat is Agora?

Agora is de repository van Deque (gehost door JFrog als een artefactfabriek of artifactory), die binaire artefacten (pakketten, bibliotheken en uitvoerbare bestanden) veilig opslaat en waarvoor een account nodig is om toegang te krijgen. Agora host de Axe Linter Connector (zowel het npm-pakket als het handmatig te downloaden uitvoerbare bestand).

Maak een Agora Identiteitstoken aan

De eerste stap is het aanmaken van een identiteitstoken dat npm zal gebruiken om je Agora-sessie te authenticeren. Agora-identiteitstokens verlopen na een jaar, dus ze moeten jaarlijks worden vernieuwd.

1. Bezoek je Agora profielpagina om een identiteitstoken te verkrijgen. (Als je niet bent ingelogd bij Agora, kun je na het inloggen worden doorgestuurd naar een andere landingspagina dan je profielpagina. Klik nogmaals op de dezelfde link nadat je bent ingelogd om naar je profielpagina te gaan. Of klik op de knop rechts van de helpknop in de rechterbovenhoek en klik vervolgens op Profiel bewerken.)
2. Klik op Genereer een Identiteitstoken.
3. Voeg een beschrijving toe om het token in de toekomst te kunnen identificeren. (Optioneel)
4. Klik op het kopieericoon om het identiteitstoken naar je klembord te kopiëren. (Het kan handig zijn om dit identiteitstoken in een wachtwoordmanager op te slaan, omdat je het niet opnieuw kunt ophalen.)

Stel je .npmrc

nu je een Agora-identiteitstoken hebt, kun je je .npmrc bestand instellen om het gebruik van de npm-infrastructuur mogelijk te maken voor het installeren van de Connector.

1. Bezoek de Toegang instellen voor Agora-pakketten site om de configuratie te maken die je in je .npmrc bestand kunt plakken. Merk op dat geen van de informatie op deze pagina wordt opgeslagen of verzonden.
2. Voeg je e-mailadres toe (dit moet het adres zijn waarmee je bent geregistreerd op de Agora-site).
3. Plak je identiteitstoken in het bijbehorende tekstvak.
4. Klik op Genereer Configuratie om een configuratie te maken en klik op het kopieericoon.
5. Plak de gekopieerde regels in je .npmrc bestand. Het pad naar het bestand wordt op de site gespecificeerd voor Linux, macOS en Windows.

Na het volgen van deze stappen kun je het Axe DevTools Linter Connector npm-pakket gebruiken.

Voorbeeld .npmrc

Het volgende is een voorbeeld van de regels die aan je .npmrc configuratie moeten worden toegevoegd:

@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

De waarde die is inbegrepen met _auth is de base64-codering van <email>:<identity-token>.

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

Installeren en Gebruiken

Je kunt de nieuwste versie van de Axe DevTools Connector installeren met:

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

Deze opdracht installeert de Connector wereldwijd. Controleer de installatie met behulp van de --version optie:

axe-linter-connector --version

Volgende Stappen

• Zie de documentatie voor de Axe Linter Connector.
• (Externe JFrog-documentatie) Verbind je npm-client met Artifactory voor een gedetailleerde bespreking van hoe je je .npmrc handmatig kunt configureren.