Тестирование доступности веб-приложений: чем отличается от сайта
Веб-приложение тестируют по тому же стандарту, что и сайт, 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 из своих инструментов и получайте подписанное сообщение, когда проверка завершается.