# Testowanie dostępności aplikacji webowych: czym różni się od strony
URL: https://pandus.online/pl/testowanie-dostepnosci-aplikacji-webowych
Updated: 2026-10-21

Jak testować dostępność aplikacji webowej lub SaaS: stany, do których crawler nie dociera, axe w CI, sprawdzanie za logowaniem, skrypt klawiaturowy i sygnały od użytkowników.

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](https://pandus.online/pl/wcag-2-2-lista-kontrolna-dla-sklepu) i chcesz wiedzieć, gdzie ją skierować.

## Gdzie aplikacje webowe się psują

Sześć miejsc odpowiada za większość blokerów, które widzimy w aplikacjach:

1. **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.
2. **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](https://pandus.online/pl/dostepne-modalne-okno-dialogowe).
3. **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).
4. **Własne kontrolki.** Comboboxy, wybory daty, suwaki i przełączniki zbudowane z elementów `div` nie mają roli, nazwy ani obsługi klawiatury, dopóki ktoś ich nie doda. [Wzorzec select i combobox](https://pandus.online/pl/dostepna-lista-rozwijana-combobox) pokazuje oczekiwane zachowanie.
5. **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ę.
6. **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](https://pandus.online/pl/dostepne-komunikaty-bledow-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](https://pandus.online/pl/testy-dostepnosci-playwright-axe-core) 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](https://pandus.online/pl/rozszerzenie-do-sprawdzania-dostepnosci) 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:

1. Odłącz mysz, otwórz stronę logowania i zaloguj się tylko klawiszami Tab i Enter. Czy na każdym kroku widzisz, gdzie jesteś?
2. Otwórz główne okno produktu. Czy fokus do niego przechodzi? Czy Escape je zamyka i przywraca Cię z powrotem?
3. Wywołaj komunikat o sukcesie i błąd. Czy z włączonym czytnikiem ekranu (NVDA, VoiceOver) są ogłaszane?
4. Użyj głównej tabeli lub listy: sortuj, filtruj, otwórz wiersz, wykonaj akcję w wierszu. Czy gdziekolwiek potrzebowałeś myszy?
5. 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](https://pandus.online/pl/sdk-dostepnosc-analityka) 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](https://pandus.online/pl/informacja-o-dostepnosci-uslugi) ma szablon; Pandus tworzy szkic z ankiety.
- **Accessibility Conformance Report** w [formacie VPAT](https://pandus.online/pl/vpat-raport-zgodnosci-acr), 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ą.

Q: Czy sprawdzarka dostępności online może przetestować moją aplikację webową?
A: Tylko strony, do których dociera bez logowania, w stanie początkowym. Dla samej aplikacji potrzebujesz sprawdzenia tam, gdzie jest stan: w CI z przeglądarką, która się loguje, w rozszerzeniu do przeglądarki na otwartym ekranie albo w przeglądarkach użytkowników z SDK.

Q: Ile automatyzacja znajduje w aplikacji webowej?
A: Reguły automatyczne znajdują część problemów, tak samo jak na stronie: kontrast, nazwy, etykiety, role. Kolejność fokusu, zarządzanie fokusem w oknach i przy zmianach trasy oraz to, czy powiadomienie zostało ogłoszone, wymagają człowieka z klawiaturą i czytnikiem ekranu.

Q: Gdzie własne komponenty zawodzą najczęściej?
A: Okna, które nie więżą i nie zwracają fokusu, wybory daty i comboboxy działające tylko myszą, tabele z przyciskami-ikonami bez nazwy oraz powiadomienia, które znikają, zanim ktoś je usłyszy.

Q: Czy potrzebujemy VPAT dla aplikacji webowej?
A: Jeśli sprzedajesz podmiotom publicznym lub dużym organizacjom, kupujący poproszą o Accessibility Conformance Report w formacie VPAT. Pandus generuje szkic z automatycznego sprawdzenia w planach Agency; pełny ACR wymaga przeglądu ręcznego.
