Axe DevTools für das Web für Node.js und browserbasiertes Testen
Übersicht über die verfügbaren Node.js- und JavaScript-Integrationen mit Axe DevTools für das Web
Diese Seite präsentiert Ihnen Optionen für die Entwicklung mit Node.js und JavaScript mit Axe DevTools für Web. Jeder Eintrag unten nennt das npm-Paket, zu dem er Dokumentation bietet, sodass Sie ein Ihnen bekanntes Paket mit seinem Leitfaden abgleichen können.
Jedes der unten aufgeführten Pakete enthält eigene TypeScript-Typdeklarationen, sodass kein separates @types/-Paket installiert werden muss und die Axe DevTools API in beiden Sprachen gleich ist. Die Anleitungen zum Importieren und Schreiben von Tests für jede Integration kennzeichnen ihre Beispiele nach Sprache und enthalten eine vollständige Beispieldatei in sowohl JavaScript als auch TypeScript.
Alle diese Pakete werden aus demselben Register installiert. Siehe Installieren Sie Axe DevTools für Web für Node.js über Deques Agora für Authentifizierungs- und Installationsanweisungen.
Unabhängig davon, welches Paket Sie wählen, werden die Scans standardmäßig nach WCAG 2.1 Stufe AA durchgeführt, wobei Best-Practice- und experimentelle Regeln deaktiviert sind. Sehen Sie sich Regeln anpassen an, um den Regelsatz zu ändern oder Best Practices zu aktivieren.
Integrationen mit Test-Frameworks
Wählen Sie das Paket, das zu dem Tool passt, das Ihre Tests bereits verwenden. Jeder Leitfaden behandelt die Installation, den Import und die Initialisierung, das Schreiben von Tests und die vollständige API-Referenz.
- Browser-JavaScript (
@axe-devtools/browser) - Cypress (
@axe-devtools/cypress) - Playwright JavaScript (
@axe-devtools/playwright) - Puppeteer (
@axe-devtools/puppeteer) - WebdriverIO (
@axe-devtools/webdriverio) - WebDriverJS (
@axe-devtools/webdriverjs)
Berichterstattung und Protokollierung
Diese Pakete funktionieren zusammen mit einer der oben genannten Test-Framework-Integrationen.
- Node Reporter (
@axe-devtools/reporter): erstellt Berichte aus Ihren Barrierefreiheitsergebnissen. - Node Logger (
@axe-devtools/logger): protokolliert Barrierefreiheitsergebnisse während der Ausführung Ihrer Tests.
Andere Integrationen
Benutzerdefinierte Elemente und ElementInternals
Ab Axe DevTools für Web 4.13.0 lesen Scans die ARIA-Semantik, die Webkomponenten in JavaScript über ElementInternals deklarieren, anstatt nur die im Markup vorhandenen role- und aria-*-Attribute. Keine Konfiguration ist erforderlich, und dies gilt für jede Integration auf dieser Seite. Die Semantik im DOM hat weiterhin Vorrang: Ein explizites role- oder aria-*-Attribut auf dem Element überschreibt den Wert von ElementInternals.
Ihre Komponenten müssen ihre internen Strukturen veröffentlichen, damit dies wirksam wird. Ein Komponent, der sie in einem privaten Klassenfeld speichert, kann nicht gelesen werden. Siehe Benutzerdefinierte Elemente testen, die ElementInternals verwenden.