Тестування доступності вебзастосунків: чим відрізняється від сайту
Вебзастосунок тестують за тим самим стандартом, що й сайт, WCAG 2.2 AA, але його проблеми ховаються в станах, до яких краулер ніколи не дістається: діалог, змінений маршрут, сповіщення, відфільтрована таблиця за логіном. Робочий план має чотири шари: автоматичні перевірки в CI на реальних станах, перевірки сторінок після входу в браузері, короткий сценарій із клавіатурою й живі сигнали від користувачів.
Автор: Вадим Любивий, засновник Pandus · Оновлено 21 жовтня 2026 · 5 хв читання · Як ми пишемо й перевіряємо наші посібники
На сайті одиниця — сторінка: ви відкриваєте URL, вміст на місці, перевірка його читає. У вебзастосунку одиниця — стан. Той самий URL показує порожній список, індикатор завантаження, відфільтровану таблицю або помилку залежно від того, що зробив користувач. Сторінка входу — єдине, що бачить краулер, і проблеми рідко саме там.
Цей посібник для команд, які будують SaaS-продукти, портали й внутрішні інструменти. Він передбачає, що ви знаєте чекліст WCAG 2.2 і хочете знати, куди його спрямувати.
Де ламаються вебзастосунки
Шість місць дають більшість блокерів, які ми бачимо в застосунках:
- Зміна маршруту без керування фокусом. В односторінковому застосунку змінюється URL, змінюється вміст, а фокус лишається на посиланні, якого вже немає. Користувач скринрідера не чує нічого. Виправлення: переміщати фокус на заголовок або головну область нового екрана й оновлювати заголовок документа.
- Діалоги. Діалог має отримати фокус при відкритті, утримувати Tab усередині, закриватися по Escape і повертати фокус на елемент, який його відкрив. Більшість власних діалогів провалюють хоча б одне з цього; див. патерн модального діалогу.
- Сповіщення й живі оновлення. Повідомлення, що на три секунди з’являється в кутку, невидиме для скринрідера, якщо воно не в live-регіоні. Повідомлення про статус — це критерій WCAG 2.2 (4.1.3).
- Власні елементи керування. Комбобокси, вибір дати, повзунки й перемикачі, зібрані з
div, не мають ролі, назви й поведінки з клавіатури, доки хтось їх не додасть. Патерн select і комбобокса показує очікувану поведінку. - Таблиці й списки з діями. Рядок кнопок-іконок (редагувати, видалити, завантажити) без доступної назви читається як «кнопка, кнопка, кнопка». Віртуалізовані списки, що рендерять лише видимі рядки, плутають скринрідери, які читають весь список.
- Форми з миттєвою перевіркою. Помилки, що з’являються біля поля, але не пов’язані з ним, або оголошуються раніше, ніж користувач закінчив вводити. Патерн помилок форм описує зв’язки.
Нічого екзотичного тут немає. Це звичайні будівельні блоки застосунку, і кожен із них невидимий для перевірки, яка працює на сторінці входу.
Шар 1: автоматичні перевірки в CI на реальних станах
Запускайте відкритий рушій axe-core у наскрізних тестах у тому стані, який хочете перевірити: після входу, після відкриття діалогу, після застосування фільтра. Playwright із @axe-core/playwright — звичний набір; у нашому посібнику про тести доступності з Playwright є код і набір правил, що збігається зі сканером Pandus, тож CI і щотижнева перевірка не розходяться.
Три звички роблять це корисним, а не шумним:
- Валіть збірку лише на результатах serious і critical; решту лишайте як звіт.
- Тестуйте стани, а не сторінки: один тест на діалог, на порожній стан, на стан помилки.
- Перевіряйте заголовок документа й фокус після кожної зміни маршруту в тому самому тесті.
Шар 2: екрани після входу в браузері
CI покриває те, що ви вирішили протестувати. Розширення Pandus покриває те, що у вас відкрито зараз: тестове середовище, адмінку, кабінет клієнта з реальними даними. Воно запускає ті самі правила, пояснює кожну проблему простими словами й копіює нотатку для розробника або промпт для AI-асистента. Інструменти порядку Tab і фокуса показують порядок, із яким зіткнуться користувачі клавіатури, а це найчастіша несподіванка в застосунку.
Шар 3: десять хвилин із клавіатурою
Автоматика не судить, чи має сенс порядок і чи почули сповіщення. Короткий сценарій судить, і він уміщається в огляд спринту:
- Від’єднайте мишу, відкрийте сторінку входу й увійдіть лише Tab і Enter. Чи видно на кожному кроці, де ви?
- Відкрийте головний діалог продукту. Чи переміщується в нього фокус? Чи закриває його Escape і повертає вас назад?
- Викличте повідомлення про успіх і помилку. З увімкненим скринрідером (NVDA, VoiceOver) — чи оголошуються вони?
- Скористайтеся головною таблицею чи списком: відсортуйте, відфільтруйте, відкрийте рядок, виконайте дію в рядку. Чи знадобилася десь миша?
- Змініть маршрут через навігацію. Де тепер фокус і що каже заголовок?
Там, де застрягли ви, застрягають і користувачі з клавіатурою, перемикачем або скринрідером. Запишіть п’ять відповідей: це ручна частина вашої сторінки про доступність.
Шар 4: живі сигнали від реальних користувачів
Три шари вище тестують те, що ви вирішили протестувати. Pandus SDK повідомляє, з чим користувачі зіткнулися насправді: фокус клавіатури застряг на екрані, фокус загубився після закриття діалогу, елемент без назви, на який люди клікали знову й знову, помилка форми, яку так і не оголосили, верстка, що зламалася при збільшенні. Кожен сигнал несе сторінку, елемент і критерій WCAG, а сигнали рахуються, тож перше виправлення — те, що зачіпає найбільше користувачів. На вибірці переглядів SDK також запускає axe-core на реальному стані застосунку, замінюючи всі тексти до того, як щось покине браузер.
Після виправлення сканер перевіряє знову, а живий сигнал спостерігається задану кількість днів. «Підтверджено реальними відвідувачами» — кращий статус, ніж «закрито».
Що записати
Покупці вебзастосунків просять підтвердження. Тримайте актуальними три речі:
- Сторінку про доступність із датою останньої перевірки, стандартом (WCAG 2.2 AA), відомими обмеженнями і способом повідомити про бар’єр. У посібнику із заяви про доступність є шаблон; Pandus формує чернетку з анкети.
- Accessibility Conformance Report у форматі VPAT, якщо серед ваших клієнтів є органи влади чи великі організації. Pandus формує чернетку з автоматичної перевірки на тарифах Agency; ручні колонки потребують людини.
- Список відкритих проблем із відповідальними й датами, експортований у Jira або GitHub, щоб наступний спринт його мав.
Автоматичні перевірки, розширення і SDK знаходять частину проблем; сценарій із клавіатурою й ручна перевірка знаходять решту. У кожному звіті ми кажемо, що це автоматична перевірка, а не повний аудит, і ніщо тут не є юридичною консультацією.
Читайте також
Посібники та інструменти
- Тестування доступності з Playwright: перевірки WCAG у вашому наборі тестів
- Доступність, SEO і швидкість будь-якої сторінки одним кліком
- Доступне модальне вікно
Статті довідки
-
Підключіть розширення браузера до акаунта
Перевіряйте сторінки за логіном, зберігайте результат у сайт і запускайте перевірку всього сайту з браузера.
-
API-токени та webhooks
Створіть токен, звертайтеся до API зі своїх інструментів і отримуйте підписане повідомлення, коли перевірка завершується.