Automatyzacja testów dostępności z axe-core i WCAG.
Automatyzacja testów dostępności w Nexus StudioQA uruchamia axe-core na bieżącej stronie na koniec testu i wyświetla każdą naruszoną regułę WCAG wraz z jej wagą i elementami, których dotyczy. Domyślnie ma charakter informacyjny. W trybie ścisłym test zakończony powodzeniem, w którym wykryto naruszenie o wadze poważnej lub wyższej, otrzymuje status A11Y_VIOLATION. Automatyczne kontrole wykrywają tylko część problemów z dostępnością, więc nie zastępują ręcznej weryfikacji.
Autorzy to zespół Nexus StudioQA, Verdict System LLC.
Ostatnia aktualizacja: .
Co jest sprawdzane i jak to włączyć
Kontrola jest wyłączona, dopóki jej nie włączysz: --a11y dla jednego uruchomienia lub NEXUS_A11Y_ENABLED=true dla każdego uruchomienia. Wymaga dodatku @axe-core/playwright; bez niego raport zawiera informację “nie zmierzono”, a wynik testu pozostaje bez zmian.
| Ustawienie | Domyślne | Co robi |
|---|---|---|
NEXUS_A11Y_ENABLED | false | Uruchamia audyt axe-core na stronie, na której kończy się test. |
NEXUS_A11Y_STANDARD | wcag21aa | Zestaw reguł: wcag2a, wcag2aa, wcag21a, wcag21aa lub wcag22aa. |
NEXUS_A11Y_FAIL_LEVEL | serious | Najniższa waga uznawana za naruszenie: minor, moderate, serious lub critical. |
NEXUS_A11Y_STRICT | false | Przy wartości true naruszenie o wadze równej progowi niepowodzenia lub wyższej nadaje testowi zakończonemu powodzeniem status A11Y_VIOLATION. |
Jak działają punktacja i status wyniku
A11Y_VIOLATION to jeden z 15 statusów wyniku. Dotyczy wyłącznie testu zakończonego powodzeniem, zwraca kod wyjścia 0 w CI, a raport i historia pokazują zastrzeżenie. Status nieudanego testu nigdy nie jest zmieniany z tego powodu, a przy uruchomieniach w trybie chaosu audyt jest pomijany. Ekran dotykowy, emulowany lub rzeczywisty, jest również sprawdzany pod kątem zgodności z WCAG 2.2 AA, które dodaje wymagania dotyczące rozmiaru celu dotykowego.
| Impact | Waga w punktacji |
|---|---|
| Krytyczna | 25 punktów za każdą naruszoną regułę |
| Poważna | 10 punktów za każdą naruszoną regułę |
| Umiarkowana | 4 punkty za każdą naruszoną regułę |
| Niewielka | 1 punkt za każdą naruszoną regułę |
Co zawiera raport
Punktacja i ocena
Wynik to 100 pomniejszone o powyższe wagi, naliczane raz za każdą naruszoną regułę, a nie za każdy element. Oceny to A od 90, B od 75, C od 60, D od 40 i F poniżej tego progu. To nasze własne podsumowanie jednej strony, a nie poziom zgodności z WCAG.
Naruszone reguły
Do 15 reguł, od najpoważniejszych naruszeń, każda z wagą, znacznikami WCAG, odnośnikiem do strony pomocy dotyczącej reguły i maksymalnie 5 przykładowymi elementami. Sekcja jest dodawana do report.md.
Liczba kontroli wymagających weryfikacji przez człowieka
axe-core oznacza niektóre kontrole jako nieukończone, gdy nie potrafi rozstrzygnąć wyniku. Raport podaje ich liczbę i wskazuje, że wymagają weryfikacji przez człowieka.
Czego nie wykrywają automatyczne kontrole
Automatyczna kontrola wykrywa tylko część problemów z dostępnością strony. Wynik bez zastrzeżeń nie oznacza, że strona jest dostępna, a Nexus StudioQA nie poświadcza zgodności z WCAG.
Znaczenie, nie tylko znaczniki
Reguła może wykryć, że obraz ma tekst alternatywny. Nie potrafi jednak ocenić, czy tekst opisuje obraz ani czy treść odnośnika ma sens poza kontekstem.
Obsługa za pomocą klawiatury lub czytnika ekranu
Ocena, czy kolejność odczytu jest logiczna i czy stronę można obsługiwać wyłącznie klawiaturą lub czytnikiem ekranu, wymaga sprawdzenia przez człowieka.
Tylko jeden stan strony na test
Audyt jest uruchamiany na stronie, na której kończy się test. Strona, do której test nigdy nie dociera, lub stan zamknięty przed jego końcem nie są objęte audytem.
Częste pytania
Czy automatyczne testy zastępują ręczny audyt dostępności?
Nie. Wykrywają naruszenia reguł, które maszyna potrafi ocenić, a pozostałe wskazują jako wymagające weryfikacji. Używaj ich do zapobiegania regresjom między ręcznymi audytami, a nie zamiast nich.
Czy problem z dostępnością spowoduje niepowodzenie kompilacji?
Domyślnie nie. Problemy są wymieniane w raporcie. Przy ustawieniu
NEXUS_A11Y_STRICT=truetest zakończony powodzeniem, w którym wykryto naruszenie o wadze równej progowi niepowodzenia lub wyższej, otrzymuje status A11Y_VIOLATION, który nadal zwraca kod wyjścia 0 w CI.Którą wersję WCAG sprawdza?
Domyślnie WCAG 2.1 AA. W ustawieniach dostępne są wersje 2.0 i 2.1 na poziomach A i AA oraz 2.2 AA. Na ekranie dotykowym dodatkowo stosuje się WCAG 2.2 AA.
Czy działa z moimi istniejącymi testami?
Tak. Działa równolegle z asercjami w testach Playwright, Selenium lub pytest uruchamianych przez Nexus StudioQA, po dodaniu
--a11ydo danego uruchomienia lub włączeniu tej opcji dla wszystkich uruchomień. Ustawienia dostępności
Uruchom na własnym komputerze.
Wypróbuj bezpłatnie wszystkie funkcje na własnych maszynach. Bez podawania karty.