Axe DevTools für Web für WebdriverIO aus Deques Agora installieren

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

Voraussetzungen

Um Axe DevTools von Agora zu installieren, müssen Sie Agora-Login-Daten besitzen. Außerdem müssen Sie über ein bestehendes NodeJS-basiertes Webprojekt verfügen, in das Sie Axe DevTools installieren können, sowie über WebdriverIO. Je nach 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, besteht darin, sich in die Agora-Web-App einzuloggen. Nach der Anmeldung können Sie ein Identitätstoken erstellen, indem Sie oben in der Leiste neben dem Hilfeknopf auf den mit Willkommen Ihre-E-Mail-Adresse beschrifteten Knopf klicken. Dort können Sie Identitätstoken generieren anklicken und den Schritten folgen, um Ihr Identitätstoken zu erstellen und zu kopieren.

Authentifizierung hinzufügen

Um auf Axe DevTools-Pakete über NPM oder Yarn zuzugreifen, müssen Sie Ihre Agora-Authentifizierungsinformationen zur Datei ~/.npmrc 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 mit Ihrer Agora-Login-E-Mail und mit dem Identitätstoken, das Sie im vorherigen Schritt kopiert haben. Die Ausgabe des Befehls sollte so 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 Registry-Informationen hinzu und dann die Ausgabe des Curl-Befehls. Das Endergebnis sollte so 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 zum Bearbeiten. Fügen Sie zuerst die Registry-Informationen hinzu und dann die Ausgabe des Curl-Befehls. Das Endergebnis sollte so 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>:<your-identity-token> in Base64 kodieren und das Produkt auf dieselbe Weise der Datei ~/.npmrc hinzufügen, wie es mit dem Curl-Befehl generiert wurde.

Installation

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

npm install @axe-devtools/webdriverio

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, kontaktieren Sie Ihren Deque-Vertreter direkt, fragen Sie uns über unseren Support Desk oder schicken Sie uns eine E-Mail. Wir helfen Ihnen gerne weiter.