Automatisierte Barrierefreiheitstests mit axe-core und WCAG.
Bei automatisierten Barrierefreiheitstests in Nexus StudioQA prüft axe-core am Ende eines Tests die aktuelle Seite und listet jede verletzte WCAG-Regel mit ihrem Schweregrad und den betroffenen Elementen auf. Standardmäßig dienen die Ergebnisse nur als Hinweis. Im strikten Modus erhält ein bestandener Test mit einem schwerwiegenden oder kritischeren Verstoß die Kennzeichnung A11Y_VIOLATION. Automatisierte Prüfungen erkennen nur einen Teil der Barrierefreiheitsprobleme und ersetzen daher keine manuelle Prüfung.
Vom Nexus StudioQA-Team, Verdict System LLC.
Zuletzt aktualisiert: .
Was geprüft wird und wie Sie die Prüfung aktivieren
Die Prüfung bleibt deaktiviert, bis Sie sie anfordern: --a11y für einen Durchlauf oder NEXUS_A11Y_ENABLED=true für jeden Durchlauf. Sie benötigt die Erweiterung @axe-core/playwright; ohne diese steht im Bericht “nicht gemessen” und der Test bleibt unbeeinflusst.
| Einstellung | Standard | Funktionsumfang |
|---|---|---|
NEXUS_A11Y_ENABLED | false | Führt die axe-core-Prüfung auf der Seite aus, auf der der Test endet. |
NEXUS_A11Y_STANDARD | wcag21aa | Das Regelwerk: wcag2a, wcag2aa, wcag21a, wcag21aa oder wcag22aa. |
NEXUS_A11Y_FAIL_LEVEL | serious | Der niedrigste Schweregrad, der als Verstoß zählt: minor, moderate, serious oder critical. |
NEXUS_A11Y_STRICT | false | Bei true erhält ein bestandener Test bei einem Verstoß ab dem festgelegten Fehlerschweregrad die Kennzeichnung A11Y_VIOLATION. |
Wie Punktzahl und Bewertung funktionieren
A11Y_VIOLATION ist eine der 15 Bewertungen. Sie gilt nur für einen bestandenen Test, liefert in CI den Exit-Code 0 und macht den Vorbehalt im Bericht und im Verlauf sichtbar. Ein fehlgeschlagener Test wird niemals hochgestuft, und bei Chaos-Durchläufen wird die Prüfung übersprungen. Bei einem emulierten oder echten Touchscreen wird außerdem nach WCAG 2.2 AA geprüft, das zusätzlich die Zielgröße berücksichtigt.
| Impact | Gewichtung bei der Punktzahl |
|---|---|
| Kritisch | 25 Punkte pro verletzter Regel |
| Schwerwiegend | 10 Punkte pro verletzter Regel |
| Mittel | 4 Punkte pro verletzter Regel |
| Gering | 1 Punkt pro verletzter Regel |
Was der Bericht enthält
Eine Punktzahl und eine Note
Die Punktzahl ergibt sich aus 100 abzüglich der oben genannten Gewichtungen, die einmal pro verletzter Regel und nicht pro Element gezählt werden. Die Noten sind A ab 90, B ab 75, C ab 60, D ab 40 und F darunter. Dies ist unsere eigene Zusammenfassung für eine einzelne Seite, keine WCAG-Konformitätsstufe.
Die verletzten Regeln
Bis zu 15 Regeln, die schwerwiegendsten zuerst, jeweils mit Schweregrad, WCAG-Tags, einem Link zur Hilfeseite der Regel und bis zu 5 Beispielelementen. Der Abschnitt wird zu report.md hinzugefügt.
Die Anzahl der Prüfungen, die einen Menschen erfordern
axe-core kennzeichnet manche Prüfungen als unvollständig, wenn es keine Entscheidung treffen kann. Der Bericht zählt diese und weist darauf hin, dass sie eine menschliche Prüfung erfordern.
Was automatisierte Prüfungen nicht erkennen
Eine automatisierte Prüfung erkennt nur einen Teil der Barrierefreiheitsprobleme auf einer Seite. Ein unauffälliges Ergebnis bedeutet nicht, dass die Seite barrierefrei ist, und Nexus StudioQA zertifiziert keine WCAG-Konformität.
Bedeutung, nicht nur Markup
Eine Regel kann erkennen, dass ein Bild einen Alternativtext hat. Sie kann nicht beurteilen, ob der Text das Bild beschreibt oder ob der Wortlaut eines Links außerhalb seines Kontexts sinnvoll ist.
Nutzung mit Tastatur oder Screenreader
Ob die Lesereihenfolge sinnvoll ist und ob sich die Seite allein mit einer Tastatur oder mit einem Screenreader bedienen lässt, muss ein Mensch ausprobieren.
Nur ein Seitenzustand pro Test
Die Prüfung läuft auf der Seite, auf der der Test endet. Eine Seite, die der Test nie erreicht, oder ein Zustand, der vor dem Ende geschlossen wurde, wird nicht geprüft.
Häufige Fragen
Ersetzen automatisierte Tests eine manuelle Barrierefreiheitsprüfung?
Nein. Sie erkennen Verstöße gegen Regeln, die eine Maschine beurteilen kann, und führen den Rest als prüfbedürftig auf. Nutzen Sie sie, um Rückschritte zwischen manuellen Prüfungen zu verhindern, nicht als Ersatz dafür.
Lässt ein Barrierefreiheitsproblem meinen Build fehlschlagen?
Standardmäßig nicht. Probleme werden im Bericht aufgeführt. Mit
NEXUS_A11Y_STRICT=trueerhält ein bestandener Test mit einem Verstoß ab dem festgelegten Fehlerschweregrad die Kennzeichnung A11Y_VIOLATION, die in CI weiterhin den Exit-Code 0 liefert.Welche WCAG-Version wird geprüft?
Standardmäßig WCAG 2.1 AA. In den Einstellungen stehen 2.0 und 2.1 mit den Stufen A und AA sowie 2.2 AA zur Auswahl. Auf einem Touchscreen wird WCAG 2.2 AA hinzugefügt.
Funktioniert das mit meinen bestehenden Tests?
Ja. Die Prüfung läuft parallel zu den Zusicherungen in Playwright-, Selenium- oder pytest-Tests, die über Nexus StudioQA ausgeführt werden, mit
--a11yfür einen einzelnen Durchlauf oder über die Einstellung für alle. Einstellungen zur Barrierefreiheit
Führen Sie es auf Ihrem eigenen Rechner aus.
Testen Sie alle Funktionen kostenlos auf Ihren eigenen Rechnern. Keine Kreditkarte erforderlich.