screen-reader-testing

Test web applications with screen readers including VoiceOver, NVDA, and JAWS. Use when validating screen reader compatibility, debugging accessibility issues, or ensuring assistive technology support.

1. Zainstaluj skill w swoim środowisku agenta – dodaj repozytorium wshobson/agents do ścieżki pluginów accessibility-compliance.

2. Wybierz czytnik ekranu do testów na podstawie platformy: NVDA + Firefox dla Windows (pokrycie ~31%), VoiceOver + Safari dla macOS/iOS (~15%), lub JAWS + Chrome dla Windows (~40%). Dla minimalnego zakresu zacznij od NVDA i VoiceOver.

3. Włącz wybrany czytnik – na macOS naciśnij Cmd + F5 lub przejdź do Preferencje Systemowe → Dostępność → VoiceOver; na Windows uruchom NVDA lub JAWS ze standardowych ścieżek instalacji.

4. Przejdź do testowanej aplikacji webowej i przełącz czytnik w tryb Browse (domyślny do czytania treści) lub Focus (do interakcji z formularzami i kontrolkami).

5. Nawiguj po stronie używając komend czytnika – w VoiceOver: Ctrl + Option + strzałka w prawo/lewo dla następnego/poprzedniego elementu; w NVDA: strzałki lub Tab dla formularzy. Słuchaj, jak czytnik ogłasza elementy, etykiety i stany.

6. Dokumentuj problemy: brakujące etykiety, nieczytelne ARIA, nieobsługiwane dynamiczne treści, niedostępne formularze. Powtórz testy na co najmniej dwóch czytnikach dla pełnego pokrycia dostępności.