Помилка — це момент, коли система не виконала обіцянку. Текст «Щось пішло не так» залишає користувача сам на сам із невизначеністю: чи списали гроші, чи збереглася заявка, чи варто натиснути ще раз. Добре повідомлення, навпаки, пояснює стан і допомагає рухатися далі.
У наших проєктах ми помітили, що саме в моменти помилок користувачі найчастіше пишуть у підтримку, залишають низькі оцінки й видаляють застосунок. Причина не в самій помилці — збої трапляються у всіх, — а в тому, що людина не розуміє, що сталося і що робити. Нижче — як ми проєктуємо повідомлення про помилки, щоб вони зберігали довіру.
Що має містити повідомлення
Нільсенівська евристика № 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 підходить для некритичних подій («Не вдалося оновити стрічку»), але не для втрати даних чи невдалого платежу: людина може його не помітити. Критичні помилки мають залишатися на екрані, доки користувач сам їх не закриє, а екранний читач повинен їх оголошувати.
Як писати тексти помилок: покроково
- Випишіть усі помилки, які може повернути API, і згрупуйте їх за дією користувача, а не за кодом.
- Для кожної групи напишіть текст за формулою: що сталося + що збережено + що робити.
- Уникайте звинувачень: не «Ви ввели неправильний номер», а «Номер має містити 9 цифр після +380».
- Перевірте тексти на довжину в усіх мовах: довгий переклад не повинен обрізатися.
- Додайте request ID у технічні деталі та налаштуйте пошук за ним у логах.
- Проведіть ревʼю текстів разом із підтримкою: вона знає, які питання ставлять клієнти.
Як тестувати помилки
Помилки рідко потрапляють у тест-план, бо «на демо все працює». Ми додаємо окремий прохід:
- офлайн на кожному ключовому екрані та втрата мережі посеред операції;
- повільна мережа з тайм-аутами (Network Link Conditioner на iOS, емуляція мережі в Android Studio);
- подвійне й швидке повторне натискання кнопки відправлення;
- закінчення сесії посеред заповнення форми;
- довгі локалізовані тексти помилок і максимальний системний шрифт;
- озвучення помилок VoiceOver і TalkBack.
Типові помилки в дизайні помилок
- Одне загальне повідомлення «Щось пішло не так» для всіх випадків.
- Очищення форми після помилки сервера: людина вводить усе заново і часто кидає.
- Помилка лише червоною рамкою без тексту — проблема і для доступності, і для розуміння.
- Нескінченний spinner замість тайм-ауту та пояснення.
- Кнопка «Спробувати ще раз», яка повторює ту саму дію з тією самою причиною збою, наприклад, без мережі.
- Жартівливий тон у критичних ситуаціях: «Ой! Гроші кудись поділися» не викликає довіри.
Чекліст
- Є карта помилок API з текстами й діями для кожної групи.
- Кожне повідомлення пояснює, що сталося, що збережено і що робити.
- Введені дані не втрачаються після помилки.
- Платежі мають три стани й ідемпотентні запити.
- Критичні помилки не зникають самі й озвучуються екранним читачем.
- Помилки протестовано офлайн, на повільній мережі, з повторними натисканнями й довгими текстами.
- Підтримка може знайти помилку за 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.



