Пустой график может означать отсутствие событий, ошибку запроса или ещё не завершённую загрузку. Если приложение сводит эти состояния к числу 0, пользователь получает ложный вывод. Первый безопасный шаг — сравнить ответ API виджета с его отображением на искусственной выборке без строк, а затем отдельно имитировать отказ источника.
Для успешной пустой выборки интерфейс объясняет применённый период и фильтры. Для отказа он сообщает, что значение неизвестно, и показывает предусмотренный способ повторить загрузку. Ожидаемый результат проверки — разные объяснения при одинаково пустом месте на графике. Придумывать число до получения данных не нужно.
Ноль — это значение, а не универсальная заглушка
| Состояние | Что известно | Что показать |
|---|---|---|
| Успешно, строк нет | Запрос выполнен в выбранной области | Нет событий за период |
| Ошибка источника | Актуальное значение неизвестно | Не удалось получить данные |
| Ещё загружается | Конечного результата пока нет | Загрузка с понятным состоянием |
| Доступен прежний снимок | Известно старое значение | Данные на указанное время |
| Нет разрешения | Показатель недоступен этой роли | Недоступно без раскрытия чужих данных |
Даже при отсутствии строк ноль подходит не каждой формуле. Число событий за период может быть нулевым, а среднее без наблюдений или доля с пустым знаменателем требуют отдельного определения. Решение фиксирует владелец показателя. Разработчик не заменяет неопределённость нулём только потому, что компонент графика ожидает число.
Ответ API должен передавать смысл состояния
Условный ответ виджета:
state: ready / empty / loading / failed / stale
value: <только если определено>
data_as_of: <время данных>
filters: <безопасное описание области>
reason_code: <публичная причина>
request_id: <для закрытой диагностики>RFC 9110 описывает 204 No Content как успешное выполнение запроса без дополнительного содержимого ответа. Проверено 14 октября 2026 года. Сам HTTP-код не сообщает, что бизнес-показатель равен нулю. Для JSON-договора, где интерфейсу нужны причина и время данных, выберите и документируйте ответ с соответствующим телом; не пытайтесь прочитать несуществующее JSON-тело у 204.
При повторной загрузке возможна гонка: пользователь сменил период, новый ответ пришёл быстро, а старый запоздал и перезаписал виджет. Свяжите ответ с идентичностью запроса и текущими фильтрами. Проверка ошибки также относится к своему запросу: поздний отказ прежнего периода не должен перекрыть уже полученные данные нового.
Старый снимок полезен только с явной маркировкой. Время последнего успешного получения ответа и время актуальности исходных данных различаются. Если API вернул кеш, надпись «обновлено сейчас» по времени HTTP-ответа вводит в заблуждение. Покажите ту границу свежести, которую действительно гарантирует источник.
Приёмка намеренно делает четыре разных пустоты
- Получить успешную пустую выборку по тестовому фильтру.
- Вернуть отказ зависимости вместо данных.
- Оставить запрос в состоянии ожидания.
- Вернуть старый снимок с известной датой.
- Быстро сменить период и поменять порядок прихода ответов.
Для каждого сценария проверяются текст, доступное действие и отсутствие выдуманного значения. Кнопка повтора не должна запускать бесконтрольный цикл запросов. Ограничьте повтор по договору сервиса и оставьте пользователю объяснимое состояние при длительном отказе. Служебный стек ошибки и внутренние адреса не выводятся в публичную карточку.
Если после выпуска виджет потерял доступность, откат возвращает прежнюю реализацию, но не делает ошибочные нули достоверной историей. Такие значения нужно отдельно пометить или пересчитать из источника. Для разбора подготовьте искусственный ответ API, выбранные фильтры, порядок завершения запросов и ожидаемую надпись. Это позволяет проверить семантику пустого состояния без выгрузки рабочих показателей.