Testowanie dostępności aplikacji webowych: czym różni się od strony
Aplikację webową testuje się według tego samego standardu co stronę, WCAG 2.2 AA, ale jej problemy kryją się w stanach, do których crawler nigdy nie dociera: okno dialogowe, zmieniona trasa, przefiltrowana tabela za logowaniem. Działający plan ma cztery warstwy: automatyczne sprawdzenia w CI na rzeczywistych stanach, sprawdzanie ekranów po zalogowaniu, krótki skrypt klawiaturowy i żywe sygnały od użytkowników.
Autor: Vadym Liubyvyi, założyciel Pandus · Zaktualizowano 21 października 2026 · 4 min czytania · Jak piszemy i sprawdzamy nasze poradniki
Na stronie jednostką jest podstrona: otwierasz URL, treść jest na miejscu, sprawdzarka ją czyta. W aplikacji webowej jednostką jest stan. Ten sam URL pokazuje pustą listę, kółko ładowania, przefiltrowaną tabelę albo błąd, zależnie od tego, co zrobił użytkownik. Strona logowania to jedyne, co widzi crawler, a problemy rzadko są właśnie tam.
Ten poradnik jest dla zespołów budujących produkty SaaS, portale i narzędzia wewnętrzne. Zakłada, że znasz listę kontrolną WCAG 2.2 i chcesz wiedzieć, gdzie ją skierować.
Gdzie aplikacje webowe się psują
Sześć miejsc odpowiada za większość blokerów, które widzimy w aplikacjach:
- Zmiana trasy bez zarządzania fokusem. W aplikacji jednostronicowej zmienia się URL, zmienia się treść, ale fokus zostaje na linku, którego już nie ma. Użytkownik czytnika ekranu nie słyszy nic. Rozwiązanie: przenieść fokus na nagłówek lub główny region nowego widoku i zaktualizować tytuł dokumentu.
- Okna dialogowe. Okno musi przejąć fokus przy otwarciu, trzymać Tab w środku, zamykać się klawiszem Escape i zwracać fokus do kontrolki, która je otworzyła. Większość własnych okien zawodzi w co najmniej jednym punkcie; zobacz wzorzec okna modalnego.
- Powiadomienia i aktualizacje na żywo. Komunikat, który na trzy sekundy pojawia się w rogu, jest niewidoczny dla czytnika ekranu, jeśli nie jest w regionie na żywo. Komunikaty o statusie to kryterium WCAG 2.2 (4.1.3).
- Własne kontrolki. Comboboxy, wybory daty, suwaki i przełączniki zbudowane z elementów
divnie mają roli, nazwy ani obsługi klawiatury, dopóki ktoś ich nie doda. Wzorzec select i combobox pokazuje oczekiwane zachowanie. - Tabele i listy z akcjami. Rząd przycisków-ikon (edytuj, usuń, pobierz) bez dostępnej nazwy czyta się jako „przycisk, przycisk, przycisk”. Zwirtualizowane listy renderujące tylko widoczne wiersze mylą czytniki ekranu, które czytają całą listę.
- Formularze z walidacją w locie. Błędy, które pojawiają się obok pola, ale nie są z nim powiązane, lub są ogłaszane, zanim użytkownik skończy pisać. Wzorzec błędów formularza opisuje powiązania.
Nic z tego nie jest egzotyczne. To zwykłe elementy składowe aplikacji, a każdy z nich jest niewidoczny dla sprawdzenia działającego na stronie logowania.
Warstwa 1: automatyczne sprawdzenia w CI na rzeczywistych stanach
Uruchamiaj otwarty silnik axe-core w testach end-to-end, w stanie, który chcesz sprawdzić: po zalogowaniu, po otwarciu okna, po zastosowaniu filtra. Playwright z @axe-core/playwright to typowa konfiguracja; nasz poradnik o testach dostępności w Playwright ma kod i zestaw reguł zgodny ze skanerem Pandus, więc CI i cotygodniowe sprawdzenie się zgadzają.
Trzy nawyki czynią to użytecznym, a nie hałaśliwym:
- Zatrzymuj build tylko na wynikach serious i critical; resztę zostaw jako raport.
- Testuj stany, nie strony: jeden test na okno, na pusty stan, na stan błędu.
- Sprawdzaj tytuł dokumentu i fokus po każdej zmianie trasy w tym samym teście.
Warstwa 2: ekrany po zalogowaniu w przeglądarce
CI pokrywa to, co postanowiłeś przetestować. Rozszerzenie Pandus pokrywa to, co masz otwarte teraz: środowisko testowe, panel administracyjny, konto klienta z prawdziwymi danymi. Uruchamia te same reguły, wyjaśnia każdy problem prostym językiem i kopiuje notatkę dla dewelopera lub prompt dla asystenta AI. Narzędzia kolejności Tab i fokusu pokazują kolejność, którą napotkają użytkownicy klawiatury, a to najczęstsza niespodzianka w aplikacji.
Warstwa 3: dziesięć minut z klawiaturą
Automatyzacja nie ocenia, czy kolejność ma sens ani czy powiadomienie zostało usłyszane. Krótki skrypt to ocenia i mieści się w przeglądzie sprintu:
- Odłącz mysz, otwórz stronę logowania i zaloguj się tylko klawiszami Tab i Enter. Czy na każdym kroku widzisz, gdzie jesteś?
- Otwórz główne okno produktu. Czy fokus do niego przechodzi? Czy Escape je zamyka i przywraca Cię z powrotem?
- Wywołaj komunikat o sukcesie i błąd. Czy z włączonym czytnikiem ekranu (NVDA, VoiceOver) są ogłaszane?
- Użyj głównej tabeli lub listy: sortuj, filtruj, otwórz wiersz, wykonaj akcję w wierszu. Czy gdziekolwiek potrzebowałeś myszy?
- Zmień trasę z nawigacji. Gdzie jest teraz fokus i co mówi tytuł?
Tam, gdzie utknąłeś, utkną też użytkownicy klawiatury, przełącznika lub czytnika ekranu. Zapisz pięć odpowiedzi; to ręczna część Twojej strony o dostępności.
Warstwa 4: żywe sygnały od prawdziwych użytkowników
Trzy warstwy powyżej testują to, co postanowiłeś przetestować. Pandus SDK raportuje, na co użytkownicy naprawdę natrafili: fokus klawiatury uwięziony na ekranie, fokus zgubiony po zamknięciu okna, kontrolka bez nazwy, w którą ludzie klikali raz po raz, błąd formularza, którego nigdy nie ogłoszono, układ, który się rozsypał przy powiększeniu. Każdy sygnał niesie stronę, element i kryterium WCAG, a sygnały są liczone, więc pierwsza poprawka to ta, która dotyka najwięcej użytkowników. Na próbce odsłon SDK uruchamia też axe-core na rzeczywistym stanie aplikacji, zastępując każdy tekst, zanim cokolwiek opuści przeglądarkę.
Po poprawce skaner sprawdza ponownie, a żywy sygnał jest obserwowany przez ustaloną liczbę dni. „Potwierdzone przez prawdziwych odwiedzających” to lepszy status niż „zamknięte”.
Co zapisać
Kupujący aplikacje webowe proszą o dowody. Utrzymuj aktualne trzy rzeczy:
- Stronę o dostępności z datą ostatniego sprawdzenia, standardem (WCAG 2.2 AA), znanymi ograniczeniami i sposobem zgłoszenia bariery. Poradnik deklaracji dostępności ma szablon; Pandus tworzy szkic z ankiety.
- Accessibility Conformance Report w formacie VPAT, gdy wśród Twoich klientów są podmioty publiczne lub duże organizacje. Pandus generuje szkic z automatycznego sprawdzenia w planach Agency; kolumny ręczne wymagają człowieka.
- Listę otwartych problemów z właścicielami i terminami, wyeksportowaną do Jiry lub GitHuba, by następny sprint ją miał.
Sprawdzenia automatyczne, rozszerzenie i SDK znajdują część problemów; skrypt klawiaturowy i przegląd ręczny znajdują resztę. W każdym raporcie mówimy, że to sprawdzenie automatyczne, a nie pełny audyt, i nic tutaj nie jest poradą prawną.
Czytaj także
Poradniki i narzędzia
- Testy dostępności z Playwright: kontrole WCAG w zestawie testów
- Dostępność, SEO i szybkość każdej strony jednym kliknięciem
- Dostępne modalne okno dialogowe
Artykuły pomocy
-
Połącz rozszerzenie przeglądarki z kontem
Sprawdzaj strony za logowaniem, zapisuj wynik w serwisie i uruchamiaj sprawdzenie całej strony z przeglądarki.
-
Tokeny API i webhooki
Utwórz token, wywołuj API z własnych narzędzi i otrzymuj podpisaną wiadomość po zakończeniu sprawdzenia.