Installeer Axe DevTools for Web voor Browser JavaScript vanuit Deque's Agora

Voor klanten die geen interne artefactenrepository hebben en een duurzamere en schaalbaardere oplossing voor installatie willen dan het direct downloaden van Axe DevTools, stelt Deque haar eigen artefactenrepository beschikbaar aan geselecteerde klanten. Voor informatie over andere manieren om Axe DevTools te installeren, zie de handleiding over Installeren vanuit je Artefactenrepository.

Vereisten

Om Axe DevTools vanuit Agora te installeren, moet je in het bezit zijn van Agora-inloggegevens. Daarnaast moet je een bestaand NodeJS-gebaseerd webproject hebben om Axe DevTools binnen te installeren. Afhankelijk van de configuratie van je testomgeving kan het zijn dat je testbibliotheek als extra afhankelijkheid vereist is.

Een Identiteitstoken aanmaken

De eenvoudigste manier om een Identiteitstoken aan te maken, is via de Agora webapp. Zodra je bent ingelogd, kun je een Identiteitstoken aanmaken door op de knop met het label Welkom je-e-mailadres in de bovenste balk naast de helpknop te klikken. Vanaf daar moet je een Identiteitstoken genereren en kopiëren.

Authenticatie toevoegen

Om toegang te krijgen tot Axe DevTools pakketten via NPM of Yarn, moet je je Agora-authenticatie-informatie toevoegen aan een ~/.npmrc-bestand. De eenvoudigste manier om dit te doen is met een curl-opdracht.

curl -u"<your-email>":<your-identity-token> "https://agora.dequecloud.com/artifactory/api/npm/auth"

Wanneer je deze opdracht uitvoert, vervang dan door je Agora-inlog e-mailadres, en vervang door het Identiteitstoken dat je in de vorige stap hebt gekopieerd. De uitvoer van het commando moet er als volgt uitzien:

_auth = <generated-auth-string>
always-auth = true
email = <your-email>

Je .npmrc-bestand instellen (yarn/npm)

Open je ~/.npmrc-bestand voor bewerking. Voeg eerst de informatie van het register toe en daarna de uitvoer van de curl-opdracht. Het eindproduct moet er als volgt uitzien:

@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

Je .yarnrc.yml-bestand instellen (yarn modern)

Open je ~/.yarnrc.yml-bestand voor bewerking. Voeg eerst de informatie van het register toe en daarna de uitvoer van de curl-opdracht. Het eindproduct moet er als volgt uitzien:

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

Als je geen curl-opdrachten kunt uitvoeren, kun je je auth-string genereren door <your-email>:<your-identity-token> te encoderen met base-64 en het product op dezelfde manier aan het ~/.npmrc-bestand toe te voegen als wanneer het met de curl-opdracht was gegenereerd.

Installeren

Om Axe DevTools Browser JavaScript in je project te installeren, voer je dit commando uit:

npm install @axe-devtools/browser

Volgende stappen

Zodra Axe DevTools succesvol in je omgeving is geïnstalleerd, lees dan de handleiding over importeren en initialiseren.

Als je problemen hebt met de installatie van Axe DevTools, neem dan direct contact op met je Deque-vertegenwoordiger, vraag ons via onze support desk of stuur ons een e-mail. We helpen je graag verder om aan de slag te gaan.