# Тестування доступності вебзастосунків: чим відрізняється від сайту
URL: https://pandus.online/uk/testuvannia-dostupnosti-vebzastosunkiv
Updated: 2026-10-21

Як тестувати доступність вебзастосунку або SaaS: стани, яких краулер не досягає, axe у CI, перевірки за логіном, сценарій із клавіатурою та живі сигнали від користувачів.

На сайті одиниця — сторінка: ви відкриваєте URL, вміст на місці, перевірка його читає. У вебзастосунку одиниця — **стан**. Той самий URL показує порожній список, індикатор завантаження, відфільтровану таблицю або помилку залежно від того, що зробив користувач. Сторінка входу — єдине, що бачить краулер, і проблеми рідко саме там.

Цей посібник для команд, які будують SaaS-продукти, портали й внутрішні інструменти. Він передбачає, що ви знаєте [чекліст WCAG 2.2](https://pandus.online/uk/wcag-2-2-chek-lyst) і хочете знати, куди його спрямувати.

## Де ламаються вебзастосунки

Шість місць дають більшість блокерів, які ми бачимо в застосунках:

1. **Зміна маршруту без керування фокусом.** В односторінковому застосунку змінюється URL, змінюється вміст, а фокус лишається на посиланні, якого вже немає. Користувач скринрідера не чує нічого. Виправлення: переміщати фокус на заголовок або головну область нового екрана й оновлювати заголовок документа.
2. **Діалоги.** Діалог має отримати фокус при відкритті, утримувати Tab усередині, закриватися по Escape і повертати фокус на елемент, який його відкрив. Більшість власних діалогів провалюють хоча б одне з цього; див. [патерн модального діалогу](https://pandus.online/uk/dostupne-modalne-vikno).
3. **Сповіщення й живі оновлення.** Повідомлення, що на три секунди з’являється в кутку, невидиме для скринрідера, якщо воно не в live-регіоні. Повідомлення про статус — це критерій WCAG 2.2 (4.1.3).
4. **Власні елементи керування.** Комбобокси, вибір дати, повзунки й перемикачі, зібрані з `div`, не мають ролі, назви й поведінки з клавіатури, доки хтось їх не додасть. [Патерн select і комбобокса](https://pandus.online/uk/dostupnyi-vypadnyi-spysok-combobox) показує очікувану поведінку.
5. **Таблиці й списки з діями.** Рядок кнопок-іконок (редагувати, видалити, завантажити) без доступної назви читається як «кнопка, кнопка, кнопка». Віртуалізовані списки, що рендерять лише видимі рядки, плутають скринрідери, які читають весь список.
6. **Форми з миттєвою перевіркою.** Помилки, що з’являються біля поля, але не пов’язані з ним, або оголошуються раніше, ніж користувач закінчив вводити. [Патерн помилок форм](https://pandus.online/uk/dostupna-validatsiia-formy-pomylky) описує зв’язки.

Нічого екзотичного тут немає. Це звичайні будівельні блоки застосунку, і кожен із них невидимий для перевірки, яка працює на сторінці входу.

## Шар 1: автоматичні перевірки в CI на реальних станах

Запускайте відкритий рушій axe-core у наскрізних тестах у тому стані, який хочете перевірити: після входу, після відкриття діалогу, після застосування фільтра. Playwright із `@axe-core/playwright` — звичний набір; у нашому посібнику про [тести доступності з Playwright](https://pandus.online/uk/testuvannia-dostupnosti-playwright) є код і набір правил, що збігається зі сканером Pandus, тож CI і щотижнева перевірка не розходяться.

Три звички роблять це корисним, а не шумним:

- Валіть збірку лише на результатах **serious і critical**; решту лишайте як звіт.
- Тестуйте **стани, а не сторінки**: один тест на діалог, на порожній стан, на стан помилки.
- Перевіряйте **заголовок документа й фокус** після кожної зміни маршруту в тому самому тесті.

## Шар 2: екрани після входу в браузері

CI покриває те, що ви вирішили протестувати. [Розширення Pandus](https://pandus.online/uk/rozshyrennia-dlia-perevirky-dostupnosti) покриває те, що у вас відкрито зараз: тестове середовище, адмінку, кабінет клієнта з реальними даними. Воно запускає ті самі правила, пояснює кожну проблему простими словами й копіює нотатку для розробника або промпт для AI-асистента. Інструменти порядку Tab і фокуса показують порядок, із яким зіткнуться користувачі клавіатури, а це найчастіша несподіванка в застосунку.

## Шар 3: десять хвилин із клавіатурою

Автоматика не судить, чи має сенс порядок і чи почули сповіщення. Короткий сценарій судить, і він уміщається в огляд спринту:

1. Від’єднайте мишу, відкрийте сторінку входу й увійдіть лише Tab і Enter. Чи видно на кожному кроці, де ви?
2. Відкрийте головний діалог продукту. Чи переміщується в нього фокус? Чи закриває його Escape і повертає вас назад?
3. Викличте повідомлення про успіх і помилку. З увімкненим скринрідером (NVDA, VoiceOver) — чи оголошуються вони?
4. Скористайтеся головною таблицею чи списком: відсортуйте, відфільтруйте, відкрийте рядок, виконайте дію в рядку. Чи знадобилася десь миша?
5. Змініть маршрут через навігацію. Де тепер фокус і що каже заголовок?

Там, де застрягли ви, застрягають і користувачі з клавіатурою, перемикачем або скринрідером. Запишіть п’ять відповідей: це ручна частина вашої сторінки про доступність.

## Шар 4: живі сигнали від реальних користувачів

Три шари вище тестують те, що ви вирішили протестувати. [Pandus SDK](https://pandus.online/uk/sdk-dostupnist-analityka) повідомляє, з чим користувачі зіткнулися насправді: фокус клавіатури застряг на екрані, фокус загубився після закриття діалогу, елемент без назви, на який люди клікали знову й знову, помилка форми, яку так і не оголосили, верстка, що зламалася при збільшенні. Кожен сигнал несе сторінку, елемент і критерій WCAG, а сигнали рахуються, тож перше виправлення — те, що зачіпає найбільше користувачів. На вибірці переглядів SDK також запускає axe-core на реальному стані застосунку, замінюючи всі тексти до того, як щось покине браузер.

Після виправлення сканер перевіряє знову, а живий сигнал спостерігається задану кількість днів. «Підтверджено реальними відвідувачами» — кращий статус, ніж «закрито».

## Що записати

Покупці вебзастосунків просять підтвердження. Тримайте актуальними три речі:

- **Сторінку про доступність** із датою останньої перевірки, стандартом (WCAG 2.2 AA), відомими обмеженнями і способом повідомити про бар’єр. У [посібнику із заяви про доступність](https://pandus.online/uk/informatsiia-pro-dostupnist-eaa) є шаблон; Pandus формує чернетку з анкети.
- **Accessibility Conformance Report** у [форматі VPAT](https://pandus.online/uk/vpat), якщо серед ваших клієнтів є органи влади чи великі організації. Pandus формує чернетку з автоматичної перевірки на тарифах Agency; ручні колонки потребують людини.
- **Список відкритих проблем** із відповідальними й датами, експортований у Jira або GitHub, щоб наступний спринт його мав.

Автоматичні перевірки, розширення і SDK знаходять частину проблем; сценарій із клавіатурою й ручна перевірка знаходять решту. У кожному звіті ми кажемо, що це автоматична перевірка, а не повний аудит, і ніщо тут не є юридичною консультацією.

Q: Чи може онлайн-перевірка доступності протестувати мій вебзастосунок?
A: Лише сторінки, до яких вона дістається без входу, у початковому стані. Для самого застосунку потрібна перевірка там, де є стан: у CI з браузером, що входить у систему, у розширенні для браузера на відкритому екрані або в браузерах користувачів через SDK.

Q: Скільки знаходить автоматика у вебзастосунку?
A: Автоматичні правила знаходять частину проблем, так само як на сайті: контраст, назви, підписи, ролі. Порядок фокуса, керування фокусом у діалогах і при зміні маршруту, а також те, чи оголошується сповіщення, потребують людини з клавіатурою і скринрідером.

Q: Де найчастіше ламаються власні компоненти?
A: Діалоги, що не утримують і не повертають фокус, вибір дати й комбобокси, що працюють лише мишею, таблиці з кнопками-іконками без назви та сповіщення, що зникають раніше, ніж хтось їх почує.

Q: Чи потрібен VPAT для вебзастосунку?
A: Якщо ви продаєте органам влади або великим організаціям, покупці проситимуть Accessibility Conformance Report у форматі VPAT. Pandus формує чернетку з автоматичної перевірки на тарифах Agency; повний ACR потребує ручної перевірки.
