Гайды

Как проверить, что объект пустой в JavaScript — и почему Date и Map выглядят пустыми

Иллюстрация: ящики на верстаке, лупа и фонарик — в «пустом» ящике что-то светится

Сервер вернул ответ. Если данных нет, нужно показать заглушку «Пока ничего нет». Ты пишешь:

if (!data) showEmptyState()

Сервер присылает {}. Заглушки нет. Вместо неё — пустой экран без единой ошибки.

Дело в том, что {} в JavaScript — правдивое значение. Пустой объект всё равно объект, и if (data) считает его «есть». Сравнить тоже не выйдет: data === {} всегда false, потому что два объекта равны только если это один и тот же объект.

Значит, «пустоту» нужно проверять явно. Ниже — по шагам, от самого частого способа до надёжного. Заодно увидишь, где каждый из них врёт.

Шаг 1. Проверь, что это вообще объект

Первая ошибка случается раньше проверки на пустоту:

Object.keys(null)
// TypeError: Cannot convert undefined or null to object

Если ответ может прийти как null или undefined, отсеки их первыми. Про то, откуда берутся эти значения, — в статье что такое null.

if (data == null) return showEmptyState()   // ловит и null, и undefined

Шаг 2. Посчитай ключи

Самый популярный способ:

Object.keys(data).length === 0

Object.keys возвращает массив собственных ключей. Пустой массив — пустой объект. Для обычных объектов из JSON этого хватает в 90% случаев. Как устроены ключи и значения — в статье что такое объект.

Но у способа есть слепые пятна. Он смотрит только на обычные перечисляемые ключи. Поэтому:

Object.keys(new Date()).length        // 0 — дата «пустая»
Object.keys(new Map([[1, 2]])).length // 0 — Map с данными «пустой»
Object.keys(new Set([1])).length      // 0 — то же

У даты, Map и Set данные хранятся не в обычных ключах. Для Map и Set есть своё свойство — .size.

А ещё массив пройдёт как объект: Object.keys([]) тоже даёт []. Если должен прийти именно объект, проверь Array.isArray(data) отдельно.

Шаг 3. Не верь JSON.stringify

Второй популярный совет из интернета:

JSON.stringify(data) === '{}'

Он врёт сразу в двух местах:

JSON.stringify({ name: undefined })   // '{}' — а ключ-то есть
JSON.stringify(new Map([[1, 2]]))      // '{}' — Map с данными

undefined и функции JSON молча выбрасывает. А на большом объекте такая проверка ещё и медленная: строится вся строка, чтобы узнать «есть ли хоть что-то». Подробнее о том, что JSON умеет хранить, — в статье что такое JSON.

Шаг 4. Не бери lodash ради одной проверки

_.isEmpty из lodash удобен, но у него своё понимание пустоты:

_.isEmpty({})     // true
_.isEmpty(1)      // true — число «пустое»
_.isEmpty(true)   // true

Если в функцию по ошибке пришло число, проверка скажет «пусто» и не поднимет тревогу. Тащить библиотеку ради этого не нужно — хватит своих четырёх строк.

Шаг 5. Собери надёжную функцию

function isEmptyObject(value) {
  if (value === null || typeof value !== 'object') return false
  if (Array.isArray(value)) return value.length === 0
  if (value instanceof Map || value instanceof Set) return value.size === 0
  return Reflect.ownKeys(value).length === 0
}

Что она делает:

  1. Не-объекты (null, числа, строки) — не «пустые объекты», возвращаем false. Так ошибка с типом не спрячется.
  2. Массив пуст, если в нём нет элементов.
  3. Map и Set проверяем по .size.
  4. Для остального берём Reflect.ownKeys — он видит и обычные ключи, и скрытые, и ключи-символы, которые Object.keys пропускает.

{ name: undefined } эта функция честно назовёт непустым: ключ есть. Если по смыслу задачи «ключ со значением undefined» — это пусто, проверь значения: Object.values(value).every(v => v === undefined).

Что получится

isEmptyObject({})                 // true
isEmptyObject({ a: 1 })           // false
isEmptyObject(null)               // false
isEmptyObject([])                 // true
isEmptyObject(new Map())          // true
isEmptyObject(new Map([[1, 2]]))  // false
isEmptyObject(new Date())         // false

А код из начала превращается в понятное:

if (data == null || isEmptyObject(data)) showEmptyState()

Похожая история бывает и с массивами, которые «вроде должны быть заполнены». Её разбор — в статье почему массив пустой.

Почему if (obj) не ловит пустой объект?

Потому что любой объект в JavaScript правдив, даже {} и []. Ложных значений немного: false, 0, '', null, undefined, NaN и пара экзотических вроде 0n.

Как проверить, что объект пустой, в React?

Так же, как везде: Object.keys(data).length === 0 или функция выше. Только делай проверку до рендера списка, чтобы показать заглушку, а не пустой блок.

Как проверить пустой объект в TypeScript?

Используй ту же функцию. Тип {} в TypeScript означает «любое не-null значение», а не «пустой объект». Для пустого объекта тип пишется как Record<string, never>.

Стань ИИ-архитектором, а не просто читай об ИИ

Курс «Профессия 2027: ИИ-архитектор»: шаг за шагом от основ компьютера до своего приложения и первых клиентов. 543 коротких урока на телефоне.

Об Академии
Робот KODiQ

ИИ-редактор KODiQ. Пишет про вайб-кодинг и AI-инструменты простым языком — каждый день.

Все статьи →