Übersicht über das @axe-core/watcher-Paket
Das Paket @axe-core/watcher ist in Ihre Testsuite integriert, um auf Zugänglichkeitsfehler zu testen
Dokumentationsübersicht für Watcher
Die Informationen im Abschnitt @axe-core/watcher der Dokumentation bestehen aus Folgendem:
– Dieser Artikel, Übersicht, befasst sich mit dem Paket @axe-core/watcher (auch als Watcher oder axe Watcher bezeichnet). Hier finden Sie Übersichtsinformationen zum Paket, wo Sie es herunterladen können, wie Sie es installieren und Links zu anderen Ressourcen. – Systemanforderungen umfasst die Versionen und Besonderheiten der Software zur Verwendung mit Watcher. – Artikel unter JavaScript-Anweisungen und TypeScript-Anweisungen enthalten Anweisungen zur Integration von Watcher in verschiedene Testframeworks und beinhalten Beispielausschnitte sowohl für JavaScript als auch für TypeScript. Dies sind die gleichen Informationen, die Sie sehen, wenn Sie ein Projekt auf der axe Developer Hub-Site erstellen. – API-Referenz bietet eine Anleitung zu den APIs, die vom Paket @axe-core/watcher bereitgestellt werden.
Was ist Watcher?
Mit dem Paket @axe-core/watcher können Sie Ihrer vorhandenen Testsuite problemlos Barrierefreiheitstests hinzufügen. Es handelt sich um ein Node.js-Paket, das auf npmjs.com verfügbar ist und derzeit mit den gängigsten Test-Frameworks funktioniert. Ihre Tests können in JavaScript oder TypeScript geschrieben werden.
Das Paket @axe-core/watcher, integriert in Ihre End-to-End-Testsuite:
- Fügt Ihrer vorhandenen Testsuite mit minimalen Codeänderungen eine Zugänglichkeitsvalidierung hinzu, da Watcher die wichtigen Methoden und Funktionsaufrufe Ihres Testframeworks umschließt.(dh-glossary#wrapping)
- Analysiert Webseiten automatisch, wenn Sie Ihre Testsuite ausführen, und analysiert die Seiten erneut, wenn Änderungen am DOM erkannt werden (jede Änderung wird als separater Seitenstatus betrachtet) – perfekt für einseitige Webanwendungen und andere komplexe Sites mit Anmeldeseiten und anderen dynamischen Inhalten.
– Verknüpft Git-Commits mit Barrierefreiheitsergebnissen, damit Sie die Barrierefreiheit jedes Commits auswerten und den allgemeinen Barrierefreiheitsfortschritt Ihres Projekts überwachen können.
- Sendet mit jedem Seitenstatus und Git-Commit verknüpfte Zugänglichkeitsergebnisse an den Axe Developer Hub, wo die Ergebnisse verfolgt, dedupliziert und präsentiert werden.(dh-glossary#duplicate)
So erhalten Sie
Die neueste Version von @axe-core/watcher ist unter [npmjs.com] verfügbar(https://www.npmjs.com/package/@axe-core/watcher).
Installation
Sie können das Paket mit dem folgenden Befehl als Entwicklungsabhängigkeit in Ihrem Node.js-Projekt installieren:
npm install --save-dev @axe-core/watcherSystemanforderungen
Die Systemanforderungen für @axe-core/watcher finden Sie unter Systemanforderungen.
Obwohl die Axe Developer Hub-Website eine breite Browserunterstützung bietet, wird vom Paket @axe-core/watcher für Tests nur Google Chrome unterstützt. Sie können also beispielsweise nicht den Standardbrowser Electron von Cypress zum Ausführen Ihrer Tests verwenden.
API-Referenz
Eine Referenz zu den vom Paket @axe-core/watcher bereitgestellten APIs finden Sie unter API-Referenz.
Versionshinweise
Informationen zu den Änderungen in @axe-core/watcher finden Sie in den Versionshinweisen zu @axe-core/watcher.
Das Beispiele-Repo
Sie können mit dem Code im [Beispiel-Repository auf GitHub] experimentieren(https://github.com/dequelabs/watcher-examples). Es enthält Beispiele für:
Anweisungen zum Ändern Ihrer Testsuite
Der Abschnitt mit den Anweisungen in der Dokumentation enthält Anweisungen zum Ändern Ihrer Testsuite, um das Paket @axe-core/watcher einzubinden.
Dies sind dieselben Anweisungen, die Sie sehen, wenn Sie im axe Developer Hub ein neues Projekt erstellen.
Die folgenden Abschnitte enthalten Links zu den Anweisungen für jedes Testframework: