Помилка — це момент, коли система не виконала обіцянку. Текст «Щось пішло не так» залишає користувача сам на сам із невизначеністю: чи списали гроші, чи збереглася заявка, чи варто натиснути ще раз. Добре повідомлення, навпаки, пояснює стан і допомагає рухатися далі.

У наших проєктах ми помітили, що саме в моменти помилок користувачі найчастіше пишуть у підтримку, залишають низькі оцінки й видаляють застосунок. Причина не в самій помилці — збої трапляються у всіх, — а в тому, що людина не розуміє, що сталося і що робити. Нижче — як ми проєктуємо повідомлення про помилки, щоб вони зберігали довіру.

Що має містити повідомлення

Нільсенівська евристика № 9 формулює задачу так: допомогти користувачеві розпізнати, діагностувати помилку та відновитися після неї. На практиці добре повідомлення відповідає на п’ять питань:

  • Що сталося — простими словами, без технічного жаргону: «Не вдалося надіслати замовлення», а не «Error 500».
  • Чи збереглися дані — «Ваш кошик і адресу збережено».
  • Що робити зараз — конкретна дія: «Спробувати ще раз», «Змінити картку», «Перевірити з’єднання».
  • Чи потрібно чекати — «Ми спробуємо надіслати автоматично, щойно з’явиться мережа».
  • Куди звернутися, якщо проблема триває, — з ідентифікатором запиту, який підтримка зможе знайти в логах.

Не показуйте технічний код замість пояснення. Лог для команди може містити stack trace і request ID, а інтерфейс має відповідати на питання людини. Код можна додати дрібним шрифтом під поясненням — він допоможе підтримці, але не замінює тексту.

Карта помилок: від технічної причини до тексту

Щоб тексти не вигадувалися щоразу заново, ми складаємо карту типових помилок разом із бекенд-розробниками. Ось базовий варіант.

Технічна причинаЩо бачить користувачДія в інтерфейсі
Немає мережі«Немає з’єднання. Зміни збережено на пристрої»автоматичний повтор після відновлення мережі
Тайм-аут«Сервер відповідає довше, ніж зазвичай»«Спробувати ще раз», без втрати введених даних
401 — сесія закінчилася«Увійдіть знову, щоб продовжити»повторний вхід із поверненням на той самий екран
403 — немає прав«У вас немає доступу до цього розділу»пояснення, як отримати доступ
404 — об’єкт не знайдено«Це замовлення видалено або перенесено»перехід до списку
409 — конфлікт«Дані змінилися на іншому пристрої»показати актуальну версію і запропонувати вибір
422 — помилка валідаціїтекст біля конкретного поляфокус на першому полі з помилкою
429 — забагато запитів«Забагато спроб. Спробуйте через 30 секунд»таймер до наступної спроби
5xx — збій сервера«У нас технічні проблеми, ми вже працюємо над ними»повтор із затримкою, контакт підтримки

Для форм найважливіше правило — показувати помилку поруч із полем, а не загальним банером угорі. Детально про це ми писали в матеріалі про мобільні форми.

Платежі та незворотні дії: три стани замість двох

Для платежу, завантаження файла чи відправлення заявки недостатньо розрізняти «успіх» і «помилку». Потрібно щонайменше три стани: «не відправлено», «обробляється» і «завершено». Найнебезпечніший сценарій — тайм-аут під час оплати: клієнт не знає, чи пройшов платіж, а сервер міг його вже провести.

  • Використовуйте ідемпотентні ключі для запитів на оплату: повторне натискання не створить другого списання.
  • Блокуйте кнопку після першого натискання і показуйте статус обробки, а не просто spinner.
  • Після тайм-ауту запитуйте статус операції у сервера, перш ніж пропонувати «Спробувати ще раз».
  • Для незворотних дій, як вимагає критерій WCAG 3.3.4, давайте змогу перевірити, підтвердити або скасувати дію.

Як оформити саму кнопку дії, щоб вона чесно відображала стан, ми розбирали в статті про кнопку головної дії.

Помилка як частина сценарію, а не виняток

Кейс Gmail Wear OS на Android Developers показує цінність вимірювання реального запуску й пошуку вузьких місць: команда замінила анімований spinner статичним зображенням і отримала швидший старт. Для дизайну помилок висновок схожий — не приховуйте невизначені стани під безкінечним spinner. Якщо операція триває довше кількох секунд, покажіть чесний статус, а після розумного тайм-ауту — зрозуміле повідомлення й контрольовану повторну дію.

Важлива й форма подачі. Тимчасовий snackbar підходить для некритичних подій («Не вдалося оновити стрічку»), але не для втрати даних чи невдалого платежу: людина може його не помітити. Критичні помилки мають залишатися на екрані, доки користувач сам їх не закриє, а екранний читач повинен їх оголошувати.

Як писати тексти помилок: покроково

  1. Випишіть усі помилки, які може повернути API, і згрупуйте їх за дією користувача, а не за кодом.
  2. Для кожної групи напишіть текст за формулою: що сталося + що збережено + що робити.
  3. Уникайте звинувачень: не «Ви ввели неправильний номер», а «Номер має містити 9 цифр після +380».
  4. Перевірте тексти на довжину в усіх мовах: довгий переклад не повинен обрізатися.
  5. Додайте request ID у технічні деталі та налаштуйте пошук за ним у логах.
  6. Проведіть ревʼю текстів разом із підтримкою: вона знає, які питання ставлять клієнти.

Як тестувати помилки

Помилки рідко потрапляють у тест-план, бо «на демо все працює». Ми додаємо окремий прохід:

  • офлайн на кожному ключовому екрані та втрата мережі посеред операції;
  • повільна мережа з тайм-аутами (Network Link Conditioner на iOS, емуляція мережі в Android Studio);
  • подвійне й швидке повторне натискання кнопки відправлення;
  • закінчення сесії посеред заповнення форми;
  • довгі локалізовані тексти помилок і максимальний системний шрифт;
  • озвучення помилок VoiceOver і TalkBack.

Типові помилки в дизайні помилок

  • Одне загальне повідомлення «Щось пішло не так» для всіх випадків.
  • Очищення форми після помилки сервера: людина вводить усе заново і часто кидає.
  • Помилка лише червоною рамкою без тексту — проблема і для доступності, і для розуміння.
  • Нескінченний spinner замість тайм-ауту та пояснення.
  • Кнопка «Спробувати ще раз», яка повторює ту саму дію з тією самою причиною збою, наприклад, без мережі.
  • Жартівливий тон у критичних ситуаціях: «Ой! Гроші кудись поділися» не викликає довіри.

Чекліст

  1. Є карта помилок API з текстами й діями для кожної групи.
  2. Кожне повідомлення пояснює, що сталося, що збережено і що робити.
  3. Введені дані не втрачаються після помилки.
  4. Платежі мають три стани й ідемпотентні запити.
  5. Критичні помилки не зникають самі й озвучуються екранним читачем.
  6. Помилки протестовано офлайн, на повільній мережі, з повторними натисканнями й довгими текстами.
  7. Підтримка може знайти помилку за request ID.

Довіра зростає, коли продукт поводиться передбачувано навіть тоді, коли не може виконати бажану дію. Добре повідомлення про помилку — це продовження сервісу, а не визнання поразки. Ширший перелік перевірок доступності, зокрема для помилок, ви знайдете в матеріалі про доступність мобільних застосунків.

Джерела: Android Developers: Gmail Wear OS case study; Nielsen Norman Group: 10 Usability Heuristics; Nielsen Norman Group: Error-Message Guidelines; W3C: Understanding SC 3.3.3 Error Suggestion; Apple Human Interface Guidelines: Alerts; Stripe API: Idempotent requests.