# Тестирование доступности веб-приложений: чем отличается от сайта
URL: https://pandus.online/ru/testirovanie-dostupnosti-veb-prilozheniy
Updated: 2026-10-21

Как тестировать доступность веб-приложения или SaaS: состояния, до которых краулер не добирается, axe в CI, проверки за логином, сценарий с клавиатурой и живые сигналы.

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

Это руководство для команд, которые строят SaaS-продукты, порталы и внутренние инструменты. Оно предполагает, что вы знаете [чек-лист WCAG 2.2](https://pandus.online/ru/wcag-2-2-chek-list) и хотите знать, куда его направить.

## Где ломаются веб-приложения

Шесть мест дают большинство блокеров, которые мы видим в приложениях:

1. **Смена маршрута без управления фокусом.** В одностраничном приложении меняется URL, меняется содержимое, а фокус остаётся на ссылке, которой больше нет. Пользователь скринридера не слышит ничего. Исправление: перемещать фокус на заголовок или главную область нового экрана и обновлять заголовок документа.
2. **Диалоги.** Диалог должен получить фокус при открытии, удерживать Tab внутри, закрываться по Escape и возвращать фокус на элемент, который его открыл. Большинство собственных диалогов проваливают хотя бы одно из этого; см. [паттерн модального диалога](https://pandus.online/ru/dostupnoe-modalnoe-okno).
3. **Уведомления и живые обновления.** Сообщение, на три секунды появляющееся в углу, невидимо для скринридера, если оно не в live-регионе. Сообщения о статусе — это критерий WCAG 2.2 (4.1.3).
4. **Собственные элементы управления.** Комбобоксы, выбор даты, ползунки и переключатели, собранные из `div`, не имеют роли, названия и поведения с клавиатуры, пока кто-то их не добавит. [Паттерн select и комбобокса](https://pandus.online/ru/dostupnyj-vypadayushchij-spisok-combobox) показывает ожидаемое поведение.
5. **Таблицы и списки с действиями.** Ряд кнопок-иконок (редактировать, удалить, скачать) без доступного названия читается как «кнопка, кнопка, кнопка». Виртуализированные списки, рендерящие только видимые строки, путают скринридеры, читающие весь список.
6. **Формы с мгновенной проверкой.** Ошибки, появляющиеся рядом с полем, но не связанные с ним, или объявляемые раньше, чем пользователь закончил ввод. [Паттерн ошибок форм](https://pandus.online/ru/dostupnye-oshibki-formy) описывает связи.

Ничего экзотического здесь нет. Это обычные строительные блоки приложения, и каждый из них невидим для проверки, работающей на странице входа.

## Слой 1: автоматические проверки в CI на реальных состояниях

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

Три привычки делают это полезным, а не шумным:

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

## Слой 2: экраны после входа в браузере

CI покрывает то, что вы решили протестировать. [Расширение Pandus](https://pandus.online/ru/rasshirenie-dlya-proverki-dostupnosti) покрывает то, что у вас открыто сейчас: тестовое окружение, админку, кабинет клиента с реальными данными. Оно запускает те же правила, объясняет каждую проблему простыми словами и копирует заметку для разработчика или промпт для AI-ассистента. Инструменты порядка Tab и фокуса показывают порядок, с которым столкнутся пользователи клавиатуры, а это самая частая неожиданность в приложении.

## Слой 3: десять минут с клавиатурой

Автоматика не судит, имеет ли смысл порядок и услышали ли уведомление. Короткий сценарий судит, и он умещается в обзор спринта:

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

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

## Слой 4: живые сигналы от реальных пользователей

Три слоя выше тестируют то, что вы решили протестировать. [Pandus SDK](https://pandus.online/ru/sdk-dostupnost-analitika) сообщает, с чем пользователи столкнулись на самом деле: фокус клавиатуры застрял на экране, фокус потерялся после закрытия диалога, элемент без названия, на который люди кликали снова и снова, ошибка формы, которую так и не объявили, вёрстка, сломавшаяся при увеличении. Каждый сигнал несёт страницу, элемент и критерий WCAG, а сигналы считаются, так что первое исправление — то, что задевает больше всего пользователей. На выборке просмотров SDK также запускает axe-core на реальном состоянии приложения, заменяя все тексты до того, как что-то покинет браузер.

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

## Что записать

Покупатели веб-приложений просят подтверждения. Держите актуальными три вещи:

- **Страницу о доступности** с датой последней проверки, стандартом (WCAG 2.2 AA), известными ограничениями и способом сообщить о барьере. В [руководстве по заявлению о доступности](https://pandus.online/ru/zayavlenie-o-dostupnosti-eaa) есть шаблон; Pandus формирует черновик из анкеты.
- **Accessibility Conformance Report** в [формате VPAT](https://pandus.online/ru/vpat-i-acr-otchet-o-dostupnosti), если среди ваших клиентов есть органы власти или крупные организации. Pandus формирует черновик из автоматической проверки на тарифах Agency; ручные колонки требуют человека.
- **Список открытых проблем** с ответственными и датами, экспортированный в Jira или GitHub, чтобы следующий спринт его имел.

Автоматические проверки, расширение и SDK находят часть проблем; сценарий с клавиатурой и ручная проверка находят остальное. В каждом отчёте мы говорим, что это автоматическая проверка, а не полный аудит, и ничто здесь не является юридической консультацией.

Q: Может ли онлайн-проверка доступности протестировать моё веб-приложение?
A: Только страницы, до которых она добирается без входа, в начальном состоянии. Для самого приложения нужна проверка там, где есть состояние: в CI с браузером, который входит в систему, в расширении для браузера на открытом экране или в браузерах пользователей через SDK.

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

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

Q: Нужен ли VPAT для веб-приложения?
A: Если вы продаёте органам власти или крупным организациям, покупатели попросят Accessibility Conformance Report в формате VPAT. Pandus формирует черновик из автоматической проверки на тарифах Agency; полный ACR требует ручной проверки.
