Пустой график может означать отсутствие событий, ошибку запроса или ещё не завершённую загрузку. Если приложение сводит эти состояния к числу 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-ответа вводит в заблуждение. Покажите ту границу свежести, которую действительно гарантирует источник.

Приёмка намеренно делает четыре разных пустоты

  1. Получить успешную пустую выборку по тестовому фильтру.
  2. Вернуть отказ зависимости вместо данных.
  3. Оставить запрос в состоянии ожидания.
  4. Вернуть старый снимок с известной датой.
  5. Быстро сменить период и поменять порядок прихода ответов.

Для каждого сценария проверяются текст, доступное действие и отсутствие выдуманного значения. Кнопка повтора не должна запускать бесконтрольный цикл запросов. Ограничьте повтор по договору сервиса и оставьте пользователю объяснимое состояние при длительном отказе. Служебный стек ошибки и внутренние адреса не выводятся в публичную карточку.

Если после выпуска виджет потерял доступность, откат возвращает прежнюю реализацию, но не делает ошибочные нули достоверной историей. Такие значения нужно отдельно пометить или пересчитать из источника. Для разбора подготовьте искусственный ответ API, выбранные фильтры, порядок завершения запросов и ожидаемую надпись. Это позволяет проверить семантику пустого состояния без выгрузки рабочих показателей.

Проверенные источники