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

This page is not available in the language you requested. You have been redirected to the English version of the page.
Link to this page copied to clipboard

Installation der Axe DevTools Node.js-Pakete aus dem Artefakt-Repository von Deques Agora

Not for use with personal data

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.

important

Denken Sie daran, den Wert Ihres Identity Tokens beim Erstellen zu kopieren, da dies Ihre einzige Chance sein wird. Andernfalls müssen Sie ein neues Token erstellen.

Identity Tokens laufen ab (in der Regel nach einem Jahr), daher müssen Sie Ihr Token regelmäßig neu erstellen.

Authentifizierung hinzufügen

Um auf Axe DevTools-Pakete über NPM oder Yarn zuzugreifen, müssen Sie Ihre Agora-Authentifizierungsinformationen in eine ~/.npmrc-Datei hinzufügen. Das Zugriff auf Agora-Pakete konfigurieren-Werkzeug kann diesen .npmrc-Inhalt für Sie aus Ihrer Agora-E-Mail und dem Identitätstoken generieren. Alternativ ist der einfachste Weg, dies manuell zu tun, ein curl-Befehl.

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

Ersetzen Sie bei der Ausführung dieses Befehls durch Ihre Agora-Login-E-Mail und durch das im vorherigen Schritt kopierte Identitätstoken. Der Rückgabewert 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 zuerst die Registrierungsinformationen hinzu, dann das Ergebnis des curl-Befehls. Das Endergebnis 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 zuerst die Registrierungsinformationen hinzu, dann das Ergebnis des curl-Befehls. Das Endergebnis 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 Authentifizierungs-String erzeugen, indem Sie <your-email>:<your-identity-token> in Base-64 kodieren und das Produkt auf die gleiche Weise wie das Generierte mit dem curl-Befehl in die ~/.npmrc-Datei einfügen.

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.