Twoje testy nadal korzystają z Playwright, Selenium i pytest. Nie zastępujemy ich. Przygotowujemy je do zastosowań korporacyjnych, a kod, materiały dowodowe i historia pozostają Twoją własnością.

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.

UstawienieDomyślneCo robi
NEXUS_A11Y_ENABLEDfalseUruchamia audyt axe-core na stronie, na której kończy się test.
NEXUS_A11Y_STANDARDwcag21aaZestaw reguł: wcag2a, wcag2aa, wcag21a, wcag21aa lub wcag22aa.
NEXUS_A11Y_FAIL_LEVELseriousNajniższa waga uznawana za naruszenie: minor, moderate, serious lub critical.
NEXUS_A11Y_STRICTfalsePrzy 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.

ImpactWaga w punktacji
Krytyczna25 punktów za każdą naruszoną regułę
Poważna10 punktów za każdą naruszoną regułę
Umiarkowana4 punkty za każdą naruszoną regułę
Niewielka1 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=true test 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 --a11y do 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.