Installieren Sie axe DevTools for Web für Puppeteer von Agora von Deque

Für Kunden, die über kein internes Artefakt-Repository verfügen und eine nachhaltigere und skalierbarere Lösung für die Installation wünschen als das direkte Herunterladen von axe DevTools, stellt Deque ausgewählten Kunden ein eigenes Artefakt-Repository zur Verfügung. Informationen zu anderen Möglichkeiten zum Installieren von axe DevTools finden Sie in den Anleitungen zum Installieren aus einem Bundle oder zum Installieren aus Ihrem Artifact-Repository.

Voraussetzungen

Um axe DevTools von Agora zu installieren, müssen Sie über Agora-Anmeldeinformationen verfügen. Darüber hinaus müssen Sie über ein vorhandenes NodeJS-basiertes Webprojekt verfügen, in dem Sie axe DevTools installieren können. Abhängig von der Konfiguration Ihrer Testumgebung kann Ihre Testbibliothek als zusätzliche Abhängigkeit erforderlich sein.

Erstellen eines Identitätstokens

Der einfachste Weg, ein Identitätstoken zu erstellen, ist über die Agora-Webanwendung. Sobald Sie angemeldet sind, können Sie ein Identitätstoken erstellen, indem Sie in der oberen Leiste neben der Hilfe-Schaltfläche auf die Schaltfläche Willkommen Ihre E-Mail-Adresse klicken. Von dort aus können Sie Ihr Identitätstoken erstellen und kopieren.

Authentifizierung hinzufügen

Um über NPM oder Yarn auf axe DevTools-Pakete zuzugreifen, müssen Sie Ihre Agora-Authentifizierungsinformationen zu einer ~/.npmrc-Datei hinzufügen. Am einfachsten geht das mit einem Curl-Befehl.

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

Ersetzen Sie durch Ihre Agora-Anmelde-E-Mail bei der Ausführung dieses Befehls und ersetzen Sie mit dem Identitätstoken, das Sie im vorherigen Schritt kopiert haben. Die Rückgabe des Befehls sollte folgendermaßen aussehen:

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

Einrichten Ihrer .npmrc Datei (yarn/npm)

Öffnen Sie Ihre ~/.npmrc-Datei zum Bearbeiten. Fügen Sie zuerst die Registrierungsinformationen und dann die Ausgabe des Curl-Befehls hinzu. Das Endprodukt sollte wie folgt aussehen:

@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

Einrichten Ihrer .yarnrc.yml Datei (yarn modern)

Öffnen Sie Ihre Datei ~/.yarnrc.yml zum Bearbeiten. Fügen Sie zuerst die Registrierungsinformationen und dann die Ausgabe des Curl-Befehls hinzu. Das Endprodukt sollte wie folgt aussehen:

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

Wenn Sie keine curl-Befehle ausführen können, können Sie Ihre Authentifizierungszeichenfolge generieren, indem Sie <your-email> mit Base-64 kodieren:` und fügen Sie das Produkt auf dieselbe Weise zur Datei ~/.npmrc hinzu, als wäre es mit dem Befehl curl generiert worden.

Installieren

Um axe DevTools Puppeteer in Ihrem Projekt zu installieren, führen Sie diesen Befehl aus:

npm install @axe-devtools/puppeteer

Wenn Sie Puppeteer selbst noch nicht installiert haben, können Sie es mit dem Befehl installieren:

npm install puppeteer

Nächste Schritte

Nachdem axe DevTools erfolgreich in Ihrer Umgebung installiert wurde, lesen Sie die Anleitung zum Importieren und Initialisieren.

Wenn Sie Probleme bei der Installation von axe DevTools haben, wenden Sie sich direkt an Ihren Deque-Vertreter, fragen Sie uns über unseren Support-Desk oder senden Sie uns eine E-Mail. Wir unterstützen Sie gerne bei der Inbetriebnahme.