JavaScript Object.hasOwn: проверить своё свойство

Категория: JavaScript · Язык: JavaScript · Обновлено:

Object.hasOwn(obj, key) проверяет, принадлежит ли свойство самому объекту, а не его прототипу. Метод появился в ES2022 и заменяет громоздкий Object.prototype.hasOwnProperty.call(obj, key). Он безопасен для объектов с null-прототипом и для ключей, которые перекрывают hasOwnProperty.

Отличить своё свойство от унаследованного

JavaScript
const proto = {role: "admin"};
const user = Object.create(proto);
user.name = "Игорь";

console.log(Object.hasOwn(user, "name"));  // true
console.log(Object.hasOwn(user, "role"));  // false
console.log("role" in user);               // true

Оператор in проверяет всю цепочку прототипов, поэтому role для него существует. Object.hasOwn смотрит только на собственные свойства. Это важно при разборе JSON, конфигураций и объектов, созданных через Object.create(null).

Не зависеть от перекрытого метода

JavaScript
const tricky = {
    hasOwnProperty: () => false,
    name: "Анна",
};

console.log(tricky.hasOwnProperty("name")); // false
console.log(Object.hasOwn(tricky, "name")); // true

Если объект содержит собственный hasOwnProperty, вызов obj.hasOwnProperty(...) может вернуть что угодно или упасть. Object.hasOwn не зависит от прототипа и всегда работает одинаково. Ключ приводится к свойству: числа и символы поддерживаются, null и undefined как объект выбрасывают TypeError.

Для массивов Object.hasOwn(arr, 0) проверяет индекс, а Object.hasOwn(arr, "length") — собственное свойство length. Для Map и Set метод не подходит: используйте map.has(key). Для проверки наличия ключа в JSON-объекте это самый предсказуемый вариант.

Метод поддерживается в Chrome 93+, Firefox 92+, Safari 15.4+ и Node.js 16.9+. В старых окружениях используйте Object.prototype.hasOwnProperty.call. Не путайте Object.hasOwn с Object.hasOwnProperty — второго статического метода не существует.

Документация: Object.hasOwn, Object.prototype.hasOwnProperty.