Installation von Axe DevTools für Web für WebDriverJS aus Deques Agora

Für Kunden, die kein internes Artefakt-Repository haben und eine nachhaltigere und skalierbarere Lösung für die Installation suchen als das direkte Herunterladen von Axe DevTools, stellt Deque ausgewählten Kunden sein eigenes Artefakt-Repository zur Verfügung. Informationen zu anderen Möglichkeiten, Axe DevTools zu installieren, finden Sie im Leitfaden zu Installation aus Ihrem Artefakt-Repository oder Herunterladen eines Demoprojekts.

Voraussetzungen

Um Axe DevTools von Agora zu installieren, benötigen Sie Agora-Anmeldeinformationen. Darüber hinaus müssen Sie ein bestehendes NodeJS-basiertes Webprojekt besitzen, in das Sie Axe DevTools installieren können, sowie WebDriverJS. Je nach Konfiguration Ihrer Testumgebung kann Ihre Testbibliothek als zusätzliche Abhängigkeit erforderlich sein.

Erstellung eines Identitätstokens

Der einfachste Weg, ein Identitätstoken zu erstellen, ist, sich in der Agora-Web-App anzumelden. Nach dem Anmelden können Sie ein Identitätstoken generieren, indem Sie auf die Schaltfläche Willkommen Ihre-E-Mail-Adresse in der oberen Leiste neben der Hilfeschaltfläche klicken, Identitätstoken generieren auswählen, den Schritten zur Erstellung eines Identitätstokens folgen und Ihr Identitätstoken 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"

Wenn Sie diesen Befehl ausführen, ersetzen Sie durch Ihre Agora-Anmelde-E-Mail und durch das Identitätstoken, das Sie im vorherigen Schritt kopiert haben. Die Ausgabe des Befehls sollte wie folgt 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 zuerst die Registrierungsinformationen hinzu, dann die Ausgabe des Curl-Befehls. Das Endergebnis 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 ~/.yarnrc.yml-Datei zur Bearbeitung. Fügen Sie zuerst die Registrierungsinformationen hinzu, dann die Ausgabe des Curl-Befehls. Das Endergebnis 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

Falls Sie keine Curl-Befehle ausführen können, können Sie Ihren Auth-String generieren, indem Sie <your-email>:<your-identity-token> in Base64 kodieren und das Produkt auf die gleiche Weise wie mit dem Curl-Befehl zur ~/.npmrc-Datei hinzufügen.

Installation

Um Axe DevTools WebDriverJS in Ihr Projekt zu installieren, führen Sie diesen Befehl aus:

npm install @axe-devtools/webdriverjs

Nächste Schritte

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

Wenn Sie Probleme bei der Installation von Axe DevTools haben, kontaktieren Sie Ihren Deque-Ansprechpartner direkt, fragen Sie uns über unseren Support Desk oder senden Sie uns eine E-Mail. Wir helfen Ihnen gerne, einsatzbereit zu werden.