Полное руководство: проверка пустых объектов JavaScript

Самый надежный способ проверить, является ли объект JavaScript пустым, — это использовать Object.keys(obj).length === 0, который возвращает true только в том случае, если у объекта нет перечисляемых свойств. Для более полной проверки, включающей неперечисляемые свойства, можно использовать Object.getOwnPropertyNames(obj).length === 0. Эти методы идеально работают для пустых объектов, таких как {}, и являются рекомендуемыми подходами в современном JavaScript.

Содержание

• Использование метода Object.keys()
• Использование метода Object.getOwnPropertyNames()
• Использование цикла for…in
• Использование библиотек утилит
• Сравнение производительности
• Полная проверка на пустоту объекта
• Обработка специальных случаев

Использование метода Object.keys()

Наиболее распространенным и простым методом проверки пустоты объекта в JavaScript является использование метода Object.keys(). Этот статический метод возвращает массив имен собственных перечисляемых свойств заданного объекта.

function isEmpty(obj) {
    return Object.keys(obj).length === 0;
}

// Примеры
console.log(isEmpty({})); // true
console.log(isEmpty({name: "John"})); // false
console.log(isEmpty({0: "zero"})); // false

Как объясняется в Mozilla Developer Network, Object.keys() возвращает массив, элементы которого являются строками, соответствующими перечисляемым свойствам, найденным непосредственно на объекте. Когда объект пуст, этот массив будет иметь длину 0, что делает его эффективным способом проверки на пустоту.

Этот метод особенно полезен, так как он лаконичен, легко читается и хорошо работает в современных движках JavaScript. Статья Built In подтверждает, что это обычно самый простой способ определить, является ли объект пустым.

Использование метода Object.getOwnPropertyNames()

Для более тщательной проверки, включающей неперечисляемые свойства, можно использовать Object.getOwnPropertyNames(). Этот метод возвращает массив всех свойств, найденных непосредственно на объекте, независимо от их перечисляемости.

function isEmptyComplete(obj) {
    return Object.getOwnPropertyNames(obj).length === 0;
}

// Примеры
const obj1 = {};
console.log(isEmptyComplete(obj1)); // true

const obj2 = Object.defineProperty({}, "hidden", {
    value: "secret",
    enumerable: false
});
console.log(isEmptyComplete(obj2)); // false - обнаруживает неперечисляемое свойство

Согласно Flexiple, Object.getOwnPropertyNames() превосходит, когда требуется полный обзор свойств объекта, поскольку он захватывает все свойства, включая те, которые не перечисляемы. Обсуждение на Stack Overflow также подчеркивает, что этот метод обеспечивает более полную проверку пустоты, чем Object.keys().

Разница между этими методами становится важной при работе с объектами, имеющими неперечисляемые свойства, которые не будут обнаружены Object.keys(), но будут обнаружены Object.getOwnPropertyNames().

Использование цикла for…in

Еще один подход — использование цикла for...in для перебора свойств объекта. Этот метод проверяет перечисляемые свойства, включая те, что из цепочки прототипов объекта.

function isEmptyForIn(obj) {
    for (let key in obj) {
        if (obj.hasOwnProperty(key)) {
            return false;
        }
    }
    return true;
}

// Более лаконичная версия
function isEmptyForInConcise(obj) {
    for (let key in obj) {
        return false;
    }
    return true;
}

Как объясняет DEV Community, цикл for…in перебирает перечисляемые свойства объекта и возвращает каждое имя свойства. При проверке на пустоту, если цикл выполняется хотя бы один раз, объект не пуст.

Как отмечено в Stack Overflow, этот подход может быть более эффективным по памяти, чем Object.keys(), поскольку он не создает промежуточный массив всех ключей. Однако важно использовать hasOwnProperty() или аналогичные проверки, чтобы не учитывать унаследованные свойства.

Использование библиотек утилит

Если вы уже используете библиотеки утилит JavaScript, такие как jQuery или Lodash, они предоставляют удобные методы для проверки пустоты объекта.

jQuery.isEmptyObject()

// Требуется библиотека jQuery
if ($.isEmptyObject(obj)) {
    // Объект пуст
}

Lodash _.isEmpty()

// Требуется библиотека Lodash
if (_.isEmpty(obj)) {
    // Объект пуст
}

Согласно обсуждению на Stack Overflow, эти методы утилит оптимизированы и обрабатывают различные крайние случаи. Однако они добавляют внешние зависимости, поэтому для простой проверки на пустоту обычно предпочитают нативные методы JavaScript, если вы не используете эти библиотеки в своем проекте.

Сравнение производительности

При выборе метода производительность является важным фактором, особенно если вы часто выполняете проверки пустоты или работаете с большими объектами.

Результаты производительности

На основе результатов исследований:

• цикл for…in обычно показывает лучшую производительность во многих случаях, особенно при раннем прерывании при обнаружении первого свойства
• Object.keys() работает очень хорошо, особенно в Chrome и других современных браузерах
• Object.getOwnPropertyNames() немного медленнее, но обеспечивает более полную проверку

Статья Tomek Kolasa указывает, что методы, использующие цикл for-in, обычно показывают лучшую производительность. Метод проверки пустоты объекта ES6 с использованием функции Object.getOwnPropertyNames() показал лучшие результаты, чем другие, в некоторых тестах.

Эффективность использования памяти

• Object.keys() создает промежуточный массив всех ключей, что может быть интенсивным по памяти для больших объектов
• цикл for...in с ранним завершением более эффективен по памяти, так как не создает массив
• Object.getOwnPropertyNames() также создает массив, но проверяет больше свойств

Для большинства практических целей различия в производительности незначительны, если вы не выполняете сотни тысяч проверок в секунду.

Полная проверка на пустоту объекта

Для действительно полной проверки пустоты объекта, учитывающей все типы свойств (включая ключи Symbol и неперечисляемые свойства), можно объединить несколько методов:

function isCompletelyEmpty(obj) {
    // Проверка собственных перечисляемых свойств
    if (Object.keys(obj).length > 0) return false;
    
    // Проверка собственных неперечисляемых свойств
    if (Object.getOwnPropertyNames(obj).length > 0) return false;
    
    // Проверка свойств Symbol
    if (Object.getOwnPropertySymbols(obj).length > 0) return false;
    
    return true;
}

// Более лаконичная версия
function isCompletelyEmptyConcise(obj) {
    return !Object.getOwnPropertySymbols(obj).length && 
           !Object.getOwnPropertyNames(obj).length;
}

Как упоминается в обсуждении на Coderwall, этот подход гарантирует обнаружение всех типов свойств, которые могут сделать объект непустым.

Обработка специальных случаев

При проверке пустых объектов важно учитывать некоторые особые случаи:

Объекты с ключами Symbol

const obj = { [Symbol('id')]: 123 };
console.log(Object.keys(obj).length === 0); // true - пропускает ключи Symbol
console.log(Object.getOwnPropertySymbols(obj).length === 0); // false - обнаруживает Symbol

Объекты со свойствами прототипа

function MyClass() {}
MyClass.prototype.method = function() {};

const obj = new MyClass();
console.log(Object.keys(obj).length === 0); // true - проверяет только собственные свойства
console.log(obj.hasOwnProperty('method')); // false - унаследованное свойство

Null и Undefined

function safeIsEmpty(obj) {
    return obj && Object.keys(obj).length === 0;
}

// Это вызовет TypeError при прямом использовании Object.keys()
console.log(safeIsEmpty(null)); // false
console.log(safeIsEmpty(undefined)); // false

В документации Mozilla предупреждается, что undefined и null не могут быть приведены к объектам и вызовут TypeError. Всегда обрабатывайте эти случаи при работе с потенциально неопределенным вводом.

Заключение

Ключевые выводы

• Object.keys(obj).length === 0 — наиболее распространенный и эффективный метод проверки пустых объектов с перечисляемыми свойствами
• Object.getOwnPropertyNames(obj).length === 0 обеспечивает более тщательную проверку, включающую неперечисляемые свойства
• цикл for…in с ранним завершением может быть более эффективным по памяти, но требует осторожного обращения с унаследованными свойствами
• Для комплексной проверки объединяйте методы для обнаружения всех типов свойств, включая ключи Symbol
• Всегда обрабатывайте случаи null и undefined для избежания ошибок времени выполнения

Рекомендации

• Для большинства случаев использования Object.keys(obj).length === 0 — лучший выбор — он читабелен, производителен и охватывает наиболее распространенный сценарий
• Если нужно обнаруживать неперечисляемые свойства, используйте Object.getOwnPropertyNames(obj).length === 0
• Избегайте циклов for...in для проверки пустоты, если нет особых требований к производительности
• Рассмотрите использование библиотек утилит, таких как Lodash, если вы уже используете их в своем проекте

Связанные вопросы

• Как проверить пустые массивы в JavaScript? Используйте Array.isArray(arr) && arr.length === 0
• В чем разница между перечисляемыми и неперечисляемыми свойствами? Неперечисляемые свойства не появляются в циклах for...in или Object.keys(), но к ним все равно можно получить прямой доступ
• Стоит ли использовать for...in или Object.keys() для итерации? Object.keys() обычно предпочтительнее, так как он не включает унаследованные свойства и более предсказуем

Следующие шаги

Попробуйте эти методы в своем коде, чтобы определить, какой из них лучше всего соответствует вашим конкретным потребностям. Рассмотрите возможность создания функции утилиты, которая обрабатывает все крайние случаи, если вам нужна надежная проверка пустоты во всем приложении.

Источники

1. How do I test for an empty JavaScript object? - Stack Overflow
2. How to Check if an Object is Empty in JavaScript – JS Java isEmpty Equivalent - Flexiple
3. How to Check If an Object Is Empty in JavaScript | Built In
4. 7 Easy Ways To Check If An Object Is Empty In JavaScript - DEV Community
5. How to check if JavaScript Object is empty - W3Docs
6. How to check if JavaScript Object is empty (Example) - Coderwall
7. How to Check if Object is Empty in JavaScript - Fjolt
8. How to Check if an Object is Empty in JavaScript - Scaler Topics
9. How to check if an object is empty in JavaScript - AltCademy
10. JavaScript: Check if an Object is Empty - Stack Abuse