Axe DevTools für Web für Browser-JavaScript über Deques Agora installieren

Für Kunden, die kein internes Artefakt-Repository haben 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 sein eigenes Artefakt-Repository zur Verfügung. Informationen zu anderen Methoden zur Installation von Axe DevTools finden Sie im Leitfaden unter Von Ihrem Artefakt-Repository installieren.

Voraussetzungen

Um Axe DevTools von Agora zu installieren, benötigen Sie Zugangsdaten für Agora. Darüber hinaus müssen Sie bereits ein bestehendes NodeJS-basiertes Webprojekt haben, um Axe DevTools darin zu installieren. Je nach Konfiguration Ihrer Testumgebung kann es erforderlich sein, Ihre Testbibliothek als zusätzliche Abhängigkeit hinzuzufügen.

Erstellen eines Identitätstokens

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

Authentifizierung hinzufügen

Um auf die 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 zum Bearbeiten. Fügen Sie zuerst die Registry-Informationen hinzu und dann die Ausgabe 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 zum Bearbeiten. Fügen Sie zuerst die Registry-Informationen hinzu und dann die Ausgabe des Curl-Befehls. 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 erstellen, indem Sie <your-email>:<your-identity-token> in Base-64 kodieren und das Produkt auf die gleiche Weise zur ~/.npmrc-Datei hinzufügen, als ob es mit dem Curl-Befehl generiert wurde.

Installation

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

npm install @axe-devtools/browser

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 Supportdesk oder senden Sie uns eine E-Mail. Wir helfen Ihnen gerne, alles zum Laufen zu bringen.