Axe DevTools für Web für Node.js aus Deques Agora installieren

Für Kunden, die kein internes Artefakt-Repository besitzen und eine nachhaltigeren und skalierbareren Installationslösung wünschen als das direkte Herunterladen von Axe DevTools, stellt Deque sein eigenes Artefakt-Repository ausgewählten Kunden zur Verfügung. Dieser Leitfaden behandelt die Installation eines der Axe DevTools Node.js-Pakete aus dem Artefakt-Repository von Deques Agora. Für Informationen zu anderen Installationsmethoden für Axe DevTools sehen Sie sich den Leitfaden unter Von Ihrem Artefakt-Repository installieren an.

Voraussetzungen

Um Axe DevTools von Agora zu installieren, benötigen Sie Agora-Login-Daten. Zusätzlich müssen Sie ein bestehendes Node.js-basiertes Webprojekt haben, in dem Sie Axe DevTools installieren möchten. Abhängig von der Konfiguration Ihrer Testumgebung kann Ihre Testbibliothek (zum Beispiel Cypress, Playwright, Puppeteer, WebdriverIO oder WebDriverJS) als zusätzliche Abhängigkeit erforderlich sein.

Erstellen eines Identitätstokens

Der einfachste Weg, ein Identitätstoken zu erstellen, ist über die Agora-Webapp. Nach dem Login können Sie ein Identitätstoken erstellen, indem Sie auf die Schaltfläche 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. Das Zugriff auf Agora-Pakete konfigurieren-Tool kann diesen .npmrc-Inhalt für Sie aus Ihrer Agora-E-Mail und Ihrem Identity Token generieren. Andernfalls ist der einfachste Weg, dies manuell zu tun, 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 your-email durch Ihre Agora-Login-E-Mail und your-identity-token durch den Identity Token, den Sie im vorherigen Schritt kopiert haben. Behalten Sie die Anführungszeichen bei und fügen Sie keine spitzen Klammern um die ersetzten Werte hinzu: in den meisten Shells sind < und > Umleitungsoperatoren, was dazu führt, dass der Befehl mit einem irreführenden Fehler fehlschlägt. Die Rückgabe 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 das Ergebnis des curl-Befehls. 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 ~/.yarnrc.yml-Datei zur Bearbeitung. Fügen Sie zuerst die Registrierungsinformationen hinzu, dann das Ergebnis des curl-Befehls. Das Endprodukt sollte wie folgt aussehen:

npmScopes:
  axe-devtools:
    npmRegistryServer: 'https://agora.dequecloud.com/artifactory/api/npm/devtools-npm/'
    npmAlwaysAuth: true
    npmAuthIdent: <generated-auth-string>

Wenn Sie keine curl-Befehle ausführen können, können Sie Ihre Authentifizierungszeichenkette erzeugen, indem Sie Ihre Agora-E-Mail und den Identity Token im Format your-email:your-identity-token base-64-kodieren und dann das Ergebnis der ~/.npmrc-Datei hinzufügen, so als ob es mit dem curl-Befehl generiert worden wäre.

Installation

Nachdem die Authentifizierung eingerichtet ist, installieren Sie das Paket für Ihre Testbibliothek.

Browser JavaScript (@axe-devtools/browser)

npm install @axe-devtools/browser

Nach der Installation lesen Sie den Leitfaden zu Importieren und Initialisieren.

Cypress (@axe-devtools/cypress)

npm install @axe-devtools/cypress

Falls Sie Cypress selbst noch nicht installiert haben, können Sie es mit dem Befehl installieren

npm install cypress

Playwright (@axe-devtools/playwright)

npm install @axe-devtools/playwright

Falls Sie Playwright selbst noch nicht installiert haben, können Sie es mit dem Befehl installieren

npm install playwright

Nach der Installation lesen Sie den Leitfaden zu Importieren und Initialisieren.

Puppeteer (@axe-devtools/puppeteer)

npm install @axe-devtools/puppeteer

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

npm install puppeteer

Nach der Installation lesen Sie den Leitfaden zu Importieren und Initialisieren.

WebdriverIO (@axe-devtools/webdriverio)

npm install @axe-devtools/webdriverio

Nach der Installation lesen Sie den Leitfaden zu Importieren und Initialisieren.

WebDriverJS (@axe-devtools/webdriverjs)

npm install @axe-devtools/webdriverjs

Nach der Installation lesen Sie den Leitfaden zu Importieren und Initialisieren.

Nächste Schritte

Wenn Sie Probleme bei der Installation von Axe DevTools haben, wenden Sie sich direkt an Ihren Deque-Ansprechpartner, kontaktieren Sie uns über unser Support-Desk oder senden Sie uns eine E-Mail. Wir helfen Ihnen gerne weiter.