Ihre Tests bleiben bei Playwright, Selenium und pytest. Wir ersetzen sie nicht. Wir machen sie unternehmenstauglich, und Ihr Code, Ihre Nachweise und Ihr Verlauf bleiben Ihr Eigentum.

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.

EinstellungStandardFunktionsumfang
NEXUS_A11Y_ENABLEDfalseFührt die axe-core-Prüfung auf der Seite aus, auf der der Test endet.
NEXUS_A11Y_STANDARDwcag21aaDas Regelwerk: wcag2a, wcag2aa, wcag21a, wcag21aa oder wcag22aa.
NEXUS_A11Y_FAIL_LEVELseriousDer niedrigste Schweregrad, der als Verstoß zählt: minor, moderate, serious oder critical.
NEXUS_A11Y_STRICTfalseBei 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.

ImpactGewichtung bei der Punktzahl
Kritisch25 Punkte pro verletzter Regel
Schwerwiegend10 Punkte pro verletzter Regel
Mittel4 Punkte pro verletzter Regel
Gering1 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=true erhä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 --a11y fü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.