Installieren Sie Axe DevTools für Web für Puppeteer aus Deques Agora

Für Kunden, die kein internes Artefakt-Repository haben und eine nachhaltigere und skalierbarere Lösung für die Installation als den direkten Download von Axe DevTools wünschen, stellt Deque ausgewählten Kunden sein eigenes Artefakt-Repository zur Verfügung. Informationen zu anderen Installationsmöglichkeiten von Axe DevTools finden Sie in den Anleitungen zu Installation aus einem Bundle oder Installation aus Ihrem Artefakt-Repository.

Voraussetzungen

Um Axe DevTools aus Agora zu installieren, müssen Sie Agora-Anmeldedaten besitzen. Zusätzlich benötigen Sie ein bestehendes, auf NodeJS basierendes Webprojekt, in dem Sie Axe DevTools installieren können. Abhängig von der Konfiguration Ihrer Testumgebung kann möglicherweise eine zusätzliche Abhängigkeit Ihrer Testbibliothek erforderlich sein.

Erstellen eines Identitätstokens

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

Authentifizierung hinzufügen

Um auf Axe DevTools-Pakete über NPM oder Yarn zuzugreifen, müssen Sie Ihre Agora-Authentifizierungsinformationen zu einer ~/.npmrc-Datei hinzufügen. Der einfachste Weg, dies zu tun, ist mit einem curl-Befehl.

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

Ersetzen Sie beim Ausführen dieses Befehls durch Ihre Agora-Anmelde-E-Mail und durch das Identitätstoken, das Sie im vorherigen Schritt kopiert haben. Die Ausgabe 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 zur Bearbeitung. Fügen Sie zunächst die Registrierungsinformationen hinzu, dann die Ausgabe des curl-Befehls. Das Endprodukt sollte folgendermaßen 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 ~/.yarnrc.yml-Datei zur Bearbeitung. Fügen Sie zunächst die Registrierungsinformationen hinzu, dann die Ausgabe des curl-Befehls. Das Endprodukt sollte folgendermaßen 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 Ihren Auth-String erzeugen, indem Sie <your-email>:<your-identity-token> base64-kodieren und das Produkt auf die gleiche Weise wie bei einem mit dem curl-Befehl generierten Ergebnis der ~/.npmrc-Datei hinzufügen.

Installation

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 folgenden Befehl installieren

npm install puppeteer

Nächste Schritte

Sobald Axe DevTools erfolgreich in Ihrer Umgebung installiert wurde, lesen Sie die Anleitung zu importieren und initialisieren.

Wenn Sie Probleme bei der Installation von Axe DevTools haben, wenden Sie sich direkt an Ihren Deque-Ansprechpartner, fragen Sie uns über unseren Support Desk oder senden Sie uns eine E-Mail. Wir helfen Ihnen gerne, in Betrieb zu nehmen.