Axe DevTools für Web für Node.js aus Deques Agora installieren
Installation der Axe DevTools Node.js-Pakete aus dem Artefakt-Repository von Deques Agora
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.
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
_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=trueEinrichten 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: trueWenn 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/browserNach der Installation lesen Sie den Leitfaden zu Importieren und Initialisieren.
Cypress (@axe-devtools/cypress)
npm install @axe-devtools/cypressFalls Sie Cypress selbst noch nicht installiert haben, können Sie es mit dem Befehl installieren
npm install cypressPlaywright (@axe-devtools/playwright)
npm install @axe-devtools/playwrightFalls Sie Playwright selbst noch nicht installiert haben, können Sie es mit dem Befehl installieren
npm install playwrightNach der Installation lesen Sie den Leitfaden zu Importieren und Initialisieren.
Puppeteer (@axe-devtools/puppeteer)
npm install @axe-devtools/puppeteerFalls Sie Puppeteer selbst noch nicht installiert haben, können Sie es mit dem Befehl installieren
npm install puppeteerNach der Installation lesen Sie den Leitfaden zu Importieren und Initialisieren.
WebdriverIO (@axe-devtools/webdriverio)
npm install @axe-devtools/webdriverioNach der Installation lesen Sie den Leitfaden zu Importieren und Initialisieren.
WebDriverJS (@axe-devtools/webdriverjs)
npm install @axe-devtools/webdriverjsNach 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.
