QF-Test
Handbuch

19.3 A11y-Protokolle und -Reports

Für das Arbeiten mit dem Protokoll und die Generierung eines Reports (Reports und Testdokumentation) gibt es bei Barrierefreiheitstests eigene Tipps, Tricks und Besonderheiten.

19.3.1 Arbeiten mit dem Protokoll

Nach jedem Barrierefreiheitstest wird ein Protokoll angelegt, dass zur Fehleranalyse verwendet werden kann.

Protokoll eines axe-Barrierefreiheitstests
Abbildung 19.2:  Ausschnitt aus dem Protokoll eines axe-Barrierefreiheitstests

In der folgenden Abbildung ist die komplette Meldung des ausgewählten Fehlers zu sehen:

Beispiel einer Fehlermeldung
Abbildung 19.3:  Fehlermeldung zum obig ausgewählten Fehler

In Fehlermeldungen werden Elemente gelistet, die bestimmte Accessibility-Kriterien nicht erfüllen. Der zugehörige Fehler und Zusatzinformationen, wie etwa Lösungsvorschläge, werden in der Fehlermeldung beschrieben.
Für Elemente, die aufgrund unterschiedlicher Probleme, wie etwa die Verdeckung durch ein anderes Element, nicht auf eine bestimmte Regel überprüft werden konnten, werden Warnungen protokolliert.
Je nachdem, auf welchen Wert Erfolgreiche Checks anzeigen gesetzt wurde, werden auch erfolgreich durchgeführte Checks als Information im Protokoll aufgeführt.

HinweisQF-Test protokolliert neben Abbildern auch verschiedene Identifikatoren der Elemente, wie etwa den XPath oder bei Bedarf (SmartID des Elements in der Nachricht protokollieren) die SmartID. Die SmartID kann verwendet werden, um das Element innerhalb von QF-Test anzusprechen. Der XPath kann verwendet werden, um das Element im Browser mittels Entwicklertools zu finden.

Zudem erzeugt QF-Test einen Screenshot der getesteten Seite, auf dem fehlerhafte und übersprungene Elemente hervorgehoben werden.

Beispiel eines Überblicksscreenshot von Accessibility-Fehlern
Abbildung 19.4:  Bildschirmabbild: Überblick über fehlerhafte Elemente

Fehlerhafte Elemente werden rot, übersprungene Elemente gelb umrandet.

HinweisUm möglichst akkurate Abbilder und Hervorhebungen der Elemente zu erhalten, sollte die Bildschirm- und Browserskalierung auf 100% gesetzt sein.

19.3.2 Hinweise zur Reportgenerierung

Bei der Erstellung des Reports ist es sinnvoll, die zu den Fehlern erzeugten Abbilder der Elemente in den Report aufzunehmen. Hierfür muss im interaktiven Modus "Miniaturbilder einbetten" ausgewählt werden. Als Skalierung für die Miniaturbilder bietet sich ein fester Wert, wie etwa 300×200 Pixel, an.

Mögliche Einstellungen bei der Reportgenerierung
Abbildung 19.5:  Beispiel zu Einstellungen bei der Reportgenerierung

Die Kommandozeilenargumente für den batch-Modus lauten -report-thumbnails und -report-scale-thumbnails <Prozent>.