Назад в Центр знаний
Начало работы

Тестирование доступности браузерной автоматизации

Создавайте тесты автоматизации для клавиатуры, семантических имён, фокуса, объявлений и ошибок.

BotBrowser Team

Документация

Нужна структурированная документация по теме Начало работы?

Эта статья относится к редакционной библиотеке. Для пошаговой настройки, справки и постоянных обновлений переходите сразу в соответствующий раздел docs.

Тест доступности браузерной автоматизации проходит от настройки фикстуры через клавиатурные и вспомогательные проверки к ограниченным свидетельствам

Тестирование доступности в браузерной автоматизации полезнее всего, когда проверяет тот же путь, который проходит человек: найти элемент управления, добраться до него без указателя, понять его имя и состояние, выполнить задачу и восстановиться после ошибки. Автоматический запуск не может сертифицировать все аспекты доступности, но способен защищать повторяемые контракты от регрессий. Практическая цель: небольшой наблюдаемый тест, который объясняет, что проверено и что ещё требует ручной оценки. BotBrowser может предоставлять изолированный и повторяемый профиль и контекст для таких проверок, но не сертифицирует доступность и не заменяет ручную оценку с вспомогательными технологиями.

В статье Popover API: фокус, закрытие и доступность приведён пример проверки Escape, внешнего клика, возврата фокуса и резервного пути API.

Начинайте с авторизованной синтетической страницы или тестовой учётной записи. Браузер наблюдает отрисованную семантику, перемещение фокуса, клавиатурное поведение и видимый статус, но не доказывает, что реальный человек с определённой вспомогательной технологией правильно воспримет каждое взаимодействие, либо что сервис обработал удалённое изменение. Сохраняйте эти границы в результате. WCAG задаёт критерии успеха, а ARIA описывает роли, состояния и свойства.

Тестируйте и частые состояния: возвращающегося пользователя, узкую область просмотра, смену языка, заблокированное разрешение и запоздалый сетевой ответ. Для каждого состояния определите ожидаемые фокус, имя, статус и действие восстановления. Так тест остаётся близок к обещанию продукта, оставляя место для ручной проверки речи, увеличения и когнитивной нагрузки.

Прогон доступности надёжнее, когда его область видна до старта. Укажите маршрут, синтетические данные, область просмотра, режим ввода, ожидаемый ориентир и владельца очистки; решите, является ли он проверкой компонента, полной задачей или образцом совместимости. Это не позволяет выдать узкую клавиатурную проверку за аудит всего продукта и даёт основание добавить ручные проверки.

TL;DR

  • Автоматизация показывает, что элемент с доступным именем достигается клавишей Tab, что Escape закрывает диалог и что фокус возвращается к кнопке запуска, но не показывает, что именно произнесёт программа чтения с экрана.
  • Ищите элемент по роли и доступному имени, например getByRole('button', { name: 'Apply filters' }), а не по сгенерированному классу или глубокому CSS-пути.
  • После отклонённой отправки проверяйте aria-invalid="true" и связь поля с текстом ошибки, а на области результата - role="status" и aria-live="polite".
  • Фиксируйте фикстуру через page.setViewportSize({ width: 1280, height: 800 }), язык, синтетический аккаунт и reducedMotion: 'reduce', если эта настройка входит в путь.
  • Называйте нарушенный контракт в test.step() и сохраняйте один разрешённый page.screenshot(), чтобы граница доказательств не расширялась.

Содержание руководства

Превратим требование доступности в наблюдаемый контракт

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

Например, getByRole('button', { name: 'Apply filters' }) находит элемент по доступному пользователю имени, а не по расположению.

Отделяйте наблюдения браузера от смысла на стороне приложения. Кнопка может иметь доступное имя, хотя сервер отклонил её запрос; область состояния может получить текст, который программа чтения с экрана озвучит позже или не озвучит. Подтверждайте принадлежащие тесту факты браузера и отдельно проверяйте видимый пользователю результат приложения.

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

Проверяйте имена, роли и состояния без переобучения

Доступные локаторы описывают то, что может распознать человек. Роль с доступным именем, метка, связанная с полем формы, или стабильный тестовый идентификатор делают тест читаемым. Сгенерированный класс и глубокий CSS-путь почти ничего не говорят о взаимодействии и ломаются при безобидной правке макета. Если у элемента намеренно нет видимого текста, задокументируйте и проверьте его доступное имя как часть контракта компонента. Если после переименования кнопка выглядит как прежде, сопоставьте дерево ARIA со снимком экрана, прежде чем принять новое имя.

Имя и описание не взаимозаменяемы. Диалогу нужно имя, определяющее его назначение, а описание добавляет контекст. Обязательное поле должно раскрывать обязательность, а недопустимое поле должно раскрывать связь с полезным текстом ошибки. Тестируйте переход состояния, а не только исходную разметку: форма может отрисовать aria-invalid="true", оставив старое сообщение об ошибке в DOM, что запутает и автоматизацию, и вспомогательные технологии.

Не проверяйте случайные атрибуты ARIA, когда нативный HTML уже даёт нужное поведение. Нативные кнопка, метка, заголовок, список и ссылка имеют определённую семантику и клавиатурное поведение. ARIA может описать пользовательский виджет, но его владелец реализует модель взаимодействия. Проверка, видящая лишь role="button", не докажет, что пробел и Enter активируют его, фокус виден, а отключённое состояние предотвращает случайную активацию.

Проверяйте клавиатурный фокус как основной путь

Клавиатурное покрытие должно следовать задаче, а не случайной последовательности нажатий Tab. Начните с известной точки фокуса, пройдите значимые элементы, активируйте действие и запишите, куда перешёл фокус. Модальное окно переносит фокус внутрь, не выпускает его при открытии и возвращает к разумному триггеру при закрытии. Ссылка пропуска должна становиться видимой при фокусе и вести к нужному ориентиру.

Проверьте видимый индикатор фокуса, не требуя точного цвета или значения пикселя. Контракт состоит в том, что пользователь различает сфокусированный элемент в утверждённой теме. Снимок экрана помогает обзору, но не доказывает контраст на всех дисплеях. Используйте CSS и утверждения о вычисленном стиле только для свойств, которыми владеет компонент; тонкую визуальную оценку при высоком контрасте и масштабировании оставляйте человеку.

Проверяйте клавиатурные альтернативы для пользовательских виджетов. Меню, комбинированное поле, список вкладок, дерево или диалог имеют документированный набор клавиш и изменений состояния. Проверяйте поддерживаемые клавиши, выбранное или раскрытое состояние и следующую цель фокуса. Включите Escape или документированный путь отмены. Не нажимайте произвольные клавиши до изменения состояния: это превращает детерминированный контракт в зонд и усложняет классификацию отказа.

Клавиатурный тест должен покрывать и заблокированный путь. Если обязательное поле пусто, отправьте форму с клавиатуры и убедитесь, что ошибка видна, связана с полем и доступна в логическом порядке. При отказе в разрешении убедитесь, что страница предлагает пригодную альтернативу. Тест только счастливого пути может оставить пользователей клавиатуры без выхода именно там, где приложение обязано объяснить проблему.

Проверка объявлений и динамического контента

Динамическим интерфейсам нужна стратегия объявлений. Вежливое статусное сообщение может использовать live region, а срочному прерыванию может требоваться другая политика. Тест проверяет существование области, её ожидаемую роль или уровень вежливости и короткий текст после действия, но не заявляет, что каждая программа чтения с экрана, настройка речи или очередь операционной системы представит сообщение одинаково.

Для обычного обновления проверьте у нужной области role="status" и aria-live="polite".

Делайте утверждения о live region стабильными. Дождитесь именованного изменения состояния и один раз прочитайте доступный текст области; не опрашивайте её повторным запуском действия и не принимайте любую непустую строку за успех. Если приложение намеренно обновляет одну область несколько раз, проверяйте последнее значимое для пользователя сообщение и фиксируйте переход к нему. Тайм-аут должен назвать отсутствующее объявление, а не только медленную страницу.

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

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

Сделайте тестовые фикстуры и параллельные прогоны инклюзивными

Тестовая фикстура доступности владеет не только контекстом браузера: ей принадлежат исходная область просмотра, масштаб или размер текста, предпочтение уменьшенного движения, язык, синтетическая учётная запись и каталог артефактов. Укажите фиксированные для сценария значения и значения отдельной матрицы. Исполняющий модуль не должен наследовать фокус, хранилище, путь загрузки или имя снимка экрана другого модуля.

Задайте область через page.setViewportSize({ width: 1280, height: 800 }) и запишите reducedMotion: 'reduce', если эта настройка проверяется.

Используйте чистый контекст для каждого независимого пути, когда на результат влияют cookie, разрешения или сохранённые настройки. Контекст изолирует состояние браузера, но не является песочницей ОС и не удаляет серверную запись. Если приложение хранит настройку удалённо, запросите у владельца приложения поддерживаемую операцию сброса. Фикстура сообщает только то, что браузер наблюдал до и после неё. О построении таких фикстур рассказывает материал «Фикстуры и изоляция браузерной автоматизации».

Параллельные исполняющие модули должны использовать синтетические записи и частные пути вывода. Если два модуля меняют одну запись, чистый контекст не предотвратит гонку сервиса; используйте независимые записи или сериализуйте конкретное изменение. Повтор представляет собой новую попытку: при неопределённом состоянии закройте старый контекст, создайте новый собственный контекст и сообщите, что первое действие могло дойти до приложения. Не скрывайте возможную двойную отправку более долгим ожиданием. Файлам, которые создают такие запуски, посвящён материал «Надёжные тесты загрузки и скачивания файлов в браузерной автоматизации».

Добавьте в набор тестовых фикстур намеренный сбой: уберите ориентир, задержите обновление статуса или верните со синтетической страницы документированную ошибку валидации. Ожидается ограниченный сбой с именем отсутствующего контракта и детерминированной очисткой. Так проверяется тестовый механизм, а не производственный сервис, и свидетельство доступности остаётся соразмерным вопросу.

Разделяйте поддержку инструментов и заявления о соответствии

Playwright и Selenium управляют вводом с клавиатуры, проверяют доступные имена и ожидают видимое или семантическое состояние. Их API и поддержка функций браузером зависят от версии. Записывайте фреймворк, драйвер, браузер, операционную систему и относящиеся к сценарию настройки. Успешный запуск на одной комбинации даёт свидетельство только для этой комбинации, а не обещание одинакового поведения всех браузеров и вспомогательных технологий. Сторона Selenium описана в материале «Интеграция браузерного профиля с Selenium».

Автоматизированные движки правил находят отсутствующие имена, повторные ID, риски контраста и часть структурных проблем. Используйте их как помощь при обзоре, а не вместо проверки клавиатурой, масштабирования, перекомпоновки, программы чтения с экрана или исследований пользователей. Отчёт о правиле должен назвать узел и правило, а тест пути должен объяснить, может ли пользователь завершить задачу. Разделяйте отказы обоих инструментов, чтобы предупреждение правила не приняли за сбой бизнес-результата.

Когда браузер предоставляет снимок доступности или вычисленную роль, сравнивайте только стабильные и значимые для пользователя поля. Формат снимка меняется между версиями фреймворка. Предпочтительнее утверждение «кнопка Сохранить называется Сохранить профиль и включается после корректного ввода», чем побайтное сравнение дерева. Храните небольшую разницу или ссылку на элемент и осознанно проверяйте крупные изменения при переработке семантики компонента.

Спецификация W3C WebDriver определяет границу автоматизации, а WCAG определяет результаты, связанные с людьми и контентом. Ни один источник не говорит, что конкретный продукт, профиль или драйвер сертифицирует соответствие. В отчёте перечисляйте проверенные пути, среды, наблюдаемые отказы и оставшиеся ручные проверки.

Возможности и ограничения BotBrowser

BotBrowser предоставляет изолированные BrowserContexts с отдельными cookie, хранилищем и состоянием сеанса, помогая повторять авторизованные сценарии доступности с известного браузерного состояния. Он не заменяет проверки доступности Playwright или Selenium, политику программы чтения с экрана и клавиатуры, семантику приложения, обзор WCAG или серверную очистку. BotBrowser не гарантирует правильное доступное имя в приложении, озвучивание обновления live region вспомогательной технологией либо аннулирование удалённого сеанса и записи. Владелец тестовой фикстуры выбирает фреймворк, создаёт и закрывает контексты, контролирует синтетические данные и получает от владельца приложения доказательства вне браузерной границы.

Указывайте возможности и ограничения вместе. Записывайте назначение контекста, версию браузера, входные предпочтения, контракт пути, наблюдаемый результат и оставшиеся ручные проверки. Не называйте изолированный профиль доказательством доступности или способом обойти элементы управления приложения. Чистое локальное состояние делает тест повторяемым, но не меняет ответственность страницы, сервиса или вспомогательной технологии.

Разбирайте отказы и поддерживайте набор тестов

Классифицируйте отказ до изменения локатора или тайм-аута. Отсутствующее доступное имя указывает на дефект компонента; неосвобождаемая ловушка фокуса указывает на возможный дефект жизненного цикла виджета; пропавшее объявление указывает на проблему состояния страницы или интеграции вспомогательной технологии. Отключение драйвера даёт инфраструктурное свидетельство, отказ сервера является результатом приложения. Тест сохраняет первый отсутствующий контракт и направляет действие владельцу, который может его изменить.

Назовите нарушенный контракт в test.step() и сохраняйте только разрешённый page.screenshot(), когда нужно визуальное свидетельство.

После каждого изменения компонента проверяйте негативные пути: пустую форму, отклонённое значение, отказ в разрешении, медленный ответ, закрытый диалог и прерванную навигацию, когда они входят в путь. У каждой ошибки должно быть понятное объяснение и доступное следующее действие. Используйте одинаковую границу доказательств для успеха и отказа, чтобы сбой не собирал больше приватного содержимого страницы.

Перед слиянием запустите клавиатурный путь в чистом контексте, путь с чувствительными к предпочтениям условиями, если он применим, и один принудительный сбой очистки. Убедитесь, что фокус возвращается назначенному владельцу, артефакты принадлежат конкретному исполняющему модулю, а очистка выполняется после ошибок утверждения и настройки. При смене версий повторно проверяйте комбинацию браузера и фреймворка. Стабильный тест не обязан всегда проходить: его отказ должен назвать пользовательский контракт и не оставить состояние, искажающее следующий запуск.

Автоматизация доступности лучше всего работает как многоуровневая практика: семантические локаторы защищают смысл компонентов, клавиатурные пути защищают завершение задач, объявления и состояния ошибок защищают коммуникацию, а ручной обзор защищает опыт, который код не моделирует. Делайте каждый уровень явным, ограниченным и честным в отношении наблюдений. Так команда получает полезное свидетельство регрессии, не выдавая возможность браузера за неподдерживаемую гарантию соответствия.

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

Источники

См. также жизненный цикл BrowserContext и проверку взаимодействия браузера.

Отчёт о доступности должен указывать, что наблюдалось, что не наблюдалось и какому владельцу передано следующее действие. Такая привычка сохраняет точность общения с клиентами при изменении браузера, фреймворка или вспомогательной технологии.

Практический итог

Повторите клавиатурный путь в чистом контексте, проверьте доступное имя и объявленный статус и запишите рядом с результатом браузер, фреймворк и размер области просмотра. Утверждение getByRole подтверждает только ту комбинацию версий, на которой оно выполнено, поэтому масштабирование, высокий контраст и озвучивание программой чтения с экрана остаются в списке ручной проверки, а оставшаяся неопределённость попадает в ту же запись.

#Browser Automation#Accessibility Testing#Keyboard Testing#Playwright#Selenium

Эта статья входит в руководство: Начало работы с автоматизацией браузера: карта

Выполните ту же проверку в BotBrowser

Загрузите профиль, сохраните внутри браузера те сигналы, о которых только что прочитали, и подтвердите результат на своей машине до раскатки.