Frontend: поведение, доступность и визуальная проверка
После урока
вы сможете поставить агенту задачу на интерфейс так, чтобы проверить не только внешний вид, но и поведение пользователя в разных состояниях.
У интерфейса больше одного состояния
Красивый первый экран ещё не является готовым приложением. Страница должна объяснять, что происходит при загрузке, пустых данных, ошибке, потере сети и успешном действии. Если агент получил только макет с заполненным списком, он может не предусмотреть остальные случаи. Начинайте с состояния и сценария, затем переходите к визуальным деталям.
Для списка обращений в нашем проекте определим: загрузка; список; пустой результат фильтра; отсутствие обращений вообще; ошибка чтения; недоступность сети; открытый черновик; ожидающее подтверждение отправки. «Ничего не найдено» и «у вас пока нет обращений» требуют разных подсказок. В одном случае полезно сбросить фильтр, в другом — объяснить начало работы.
Контракт интерфейса
Опишите аудиторию, главное действие, источники данных, состояния, адаптивность и критерии доступности. Если есть дизайн-система, передайте используемые компоненты и токены. Просьба «сделай как известный сервис» оставляет слишком много неопределённости и часто создаёт поверхностную копию. Лучше назвать конкретные свойства: плотность информации, иерархию, контраст, размер интерактивных зон, поведение на узком экране.
Пример задания: «Создай очередь обращений с фильтром статуса и панелью черновика. Открытие обращения не отправляет ответ. Отправка требует просмотра получателя и текста. При ошибке черновик сохраняется. Фильтр доступен с клавиатуры. На ширине 360 px основной текст читается без горизонтальной прокрутки. Используй существующие компоненты проекта».
Проверяйте смысл HTML
Настоящая кнопка предпочтительнее кликабельного div, потому что уже имеет семантику и ожидаемое клавиатурное поведение. Полям нужны связанные подписи, ошибкам — понятное объяснение и связь с полем. Фокус должен быть видимым и логично перемещаться. Цвет не должен быть единственным способом сообщить статус.
WCAG 2.2 даёт критерии доступности, но короткий автоматический тест не доказывает соответствие всему стандарту. Для учебного проекта проверьте клавиатурный путь, подписи элементов, контраст, масштабирование текста и сообщение об ошибках; в реальном продукте примените требования своей организации и полноценную оценку. S54
Асинхронность и гонки
Пользователь быстро меняет фильтр с «новые» на «закрытые». Первый запрос оказался медленнее и пришёл последним. Без защиты интерфейс покажет старый результат под новым фильтром. Нужно отменить устаревший запрос или проверить, что ответ соответствует текущему идентификатору запроса. Генерация UI часто пропускает такие сценарии, потому что на демонстрационных данных всё отвечает мгновенно.
Другая типичная ошибка — двойная отправка формы. Заблокировать кнопку на время операции полезно, но это только UX-мера: сервер всё равно должен обеспечивать идемпотентность. Клиент может повторить запрос после обновления страницы или сетевого сбоя. Поэтому frontend и backend проверяются вместе на уровне сценария.
Какие доказательства нужны
Сборка подтверждает, что код проходит определённую цепочку компиляции. Unit-тест проверяет локальную логику. Интеграционный тест — взаимодействие частей. Браузерный тест — пользовательский маршрут. Скриншот помогает заметить перекрытия, обрезку текста и неверную иерархию. Ни один из этих видов проверки не заменяет остальные во всех задачах.
В Playwright проверки видимых состояний умеют повторяться до выполнения условия; это полезнее произвольных пауз, которые нестабильны на другой машине. При этом повторяющаяся проверка должна ожидать осмысленное состояние, а не маскировать бесконечную загрузку. S53
Пример сценария для агента: открыть страницу на двух ширинах; пройти форму клавиатурой; вызвать ошибку сервера; убедиться, что введённый текст сохранён; повторить запрос; проверить, что операция создалась один раз. В отчёте попросите фактические наблюдения и скриншоты, а не «визуально всё отлично», если браузер не запускался.
Работа по изображению
Если вы дали скриншот, отделите то, что видно, от того, чего он не показывает. По изображению можно оценить расположение, отступы, цвет и размер. Нельзя достоверно восстановить API, логику фильтра, состояние ошибки или точную структуру компонентов. Агент должен обозначить предположения и попросить нужные данные либо использовать явно вымышленные fixtures.
Снимайте результат в сопоставимом размере viewport. Иначе разница переноса строк может выглядеть как ошибка реализации, хотя изменился экран. Визуальные снимки полезно стабилизировать: фиксированные данные, отключённая случайная анимация, загруженные шрифты. Но стабильный снимок всё равно не доказывает доступность и корректность действий.
Практикум
Составьте спецификацию интерфейса поддержки из восьми состояний. Для каждого запишите текст сообщения, доступное действие, данные и критерий проверки. Попросите агента реализовать три наиболее важные состояния в выбранном вами учебном проекте. Затем вручную проверьте клавиатуру и ошибку сети.
Усложнение: длинное имя клиента, многострочная тема обращения, отсутствие аватара, увеличение текста до 200%, медленная загрузка. Такие примеры выявляют дефекты лучше, чем только короткий англоязычный lorem ipsum.
Критерий: интерфейс помогает пользователю понять состояние и завершить задачу. Вы можете показать, что именно проверено в браузере. Если выполнили только спецификацию без реализации, так и обозначьте результат; не называйте его протестированным приложением.
