Хорошее сообщение говорит, какое поле или действие требует внимания, описывает обнаруженную проблему простыми словами и предлагает исправление только тогда, когда оно известно. Если сервер не ответил, не маскируй это как ошибку пользователя и не сообщай, что заявка отправлена. Проверяй вместе состояние интерфейса, текст, доступное объявление и сохранность уже введённых данных.
WCAG 2.2 Success Criterion 3.3.1 требует идентифицировать автоматически обнаруженную ошибку ввода и описать её текстом. SC 3.3.3 требует предлагать исправление там, где способ исправления известен, кроме ситуаций, когда подсказка поставила бы под угрозу безопасность или цель. Эти объяснения критериев не являются usability-тестом и не подтверждают соответствие всего продукта WCAG.
Матрица аудита
| Наблюдаемое состояние | Поле/область | Что случилось | Доступное сообщение | Исправление | Сохранность данных |
|---|---|---|---|---|---|
| Поле email пустое после submit | обязательное поле не заполнено | «Укажи email» и поле явно обозначено как ошибочное | фокус на поле; сохранить остальные введённые данные | остальные корректные поля остаются заполненными | |
В email нет @ |
формат не похож на адрес электронной почты | «Проверь формат email, например [email protected]» | пример помогает исправить формат | исходный ввод не стирается автоматически | |
| Сервер не ответил | статус формы | результат запроса неизвестен | «Не удалось получить ответ. Проверь подключение и попробуй ещё раз. Мы пока не можем подтвердить отправку» | повторить позже, если операция идемпотентна/повтор безопасен; иначе сначала проверить статус | не очищать поля; не сообщать «отправлено» |
Текст сообщения должен соответствовать фактической проверке. Не утверждай, что формат неверен, если клиент проверил только пустоту; не сообщай об отсутствии сервера, если реальная причина неизвестна.
Копируемый prompt для ревью
Проверь тексты ошибок формы только по предоставленному реальному состоянию. Для каждой строки получи: поле/состояние, обнаруженную ошибку, сообщение, доступный способ объявить ошибку, известное безопасное исправление, судьбу введённых значений. Отметь
PASS,REVISEилиNEEDS_BACKEND_FACT. Не придумывай причину серверного сбоя, не утверждай, что данные сохранены/отправлены, если состояние этого не подтверждает. Предложи короткую нейтральную формулировку, укажи, какое поле должно быть названо, и когда нельзя предлагать correction. Сохрани сообщение в пределах фактов. Матрица: [вставь только синтетические или разрешённые к передаче строки].
ИИ может предложить редактуру, но разработчик/владелец формы должен сверить каждую строку с фактическими клиентскими и серверными состояниями. Не передавай модели персональные данные из журналов ошибок.
Сквозной разбор трёх ошибок
Ошибка 1 — обязательный email пуст. Плохой вариант: «Некорректно». Он не называет поле или проблему. Исправление: «Укажи email»; визуально связать сообщение с полем, а доступное дерево интерфейса должно сообщать об ошибке текстом. Сохранить введённое имя/другие значения.
Ошибка 2 — формат email не распознан. Плохой вариант: «Вы ввели неправильный email», когда проверка лишь обнаружила отсутствие @. Исправление: назвать точную проблему без обвинения: «Проверь формат email. Используй имя@домен». Подсказывать пример можно, если формат действительно ожидается. Не меняй введённый адрес автоматически.
Ошибка 3 — сервер не ответил. Плохой вариант: «Email неверный» или «Заявка успешно отправлена». Это приписывает пользователю ошибку или придумывает результат backend. Исправление: «Не удалось получить ответ. Отправка пока не подтверждена. Проверь подключение и повтори позже». Если повтор запроса может создать дубль, вместо «повтори» дай реальную процедуру проверить статус или дождаться поддержки. Сохрани содержимое формы, если это безопасно.
Разбор вымышленной QA сессии
Ниже три состояния полностью синтетические; они не описывают реальный продукт или выполненный тест.
| ID | Условное состояние формы | Черновик | Вердикт | Изменение |
|---|---|---|---|---|
| E1 | submit с пустым required email | «Ошибка» | revise: не идентифицирует поле/проблему | «Укажи email» + текстовое объявление у поля |
| E2 | в email нет @; сервер ещё не вызывался |
«Проверь подключение к интернету» | fail: причина выдумана | «Проверь формат email» |
| E3 | timeout до подтверждения ответа | «Заявка отправлена!» | fail: результат не подтверждён | «Не удалось получить ответ; отправка пока не подтверждена» |
Эта матрица проверяет только соответствие текста заявленному состоянию. Для реального аудита запроси у инженера список client/server errors и ожидаемые transition states; потом сравни с тем, что действительно сообщает интерфейс.
Проверка перед выпуском
- Для каждого поля/состояния установи, что именно система обнаружила.
- Убедись, что текст называет поле или область и формулирует проблему без скрытой причины.
- Добавляй correction только если способ известен и безопасен.
- Для серверных ошибок различай timeout, отказ, validation error и неизвестный результат; не говори «сохранено/отправлено» без подтверждения.
- Проверь, что сообщение доступно не только по цвету/иконке, связано с полем и заметно для assistive technology согласно реализации.
- Проверь поведение введённых значений после ошибки: нет ли неожиданного сброса.
- Попроси коллегу, не писавшего текст, пройти каждую ветку и пересказать, что произошло и что делать дальше.
Частые ошибки
- Одна надпись «что-то пошло не так». Добавь точное поле/действие, когда это известно.
- Решение предлагается наугад. Если backend outcome неизвестен, запроси факт или пометь
NEEDS_BACKEND_FACT. - Серверный сбой назван ошибкой ввода. Раздели клиентскую валидацию и исход запроса.
- Ошибка различается только цветом. Добавь видимую текстовую информацию, связанную с нужным полем.
- После fail очищается форма. Проверь, какие значения можно сохранить безопасно.
- Всё исправляют автоматически. Не меняй адрес/сумму/данные незаметно; пользователь должен видеть корректируемое значение.
Проверка закончена, когда для каждого реального state выбран короткий точный текст, известное исправление безопасно, а неизвестный backend результат остаётся неизвестным. Для широкой проверки клавиатуры, подписей и контраста см. аудит доступности интерфейса сайта; эта статья ограничена текстом и связкой state → error.
Материал подготовлен с помощью ИИ. Состояния формы и ответы QA вымышлены; доступность конкретного сайта не тестировалась.
