JavaScript Object.hasOwn: проверить своё свойство
Object.hasOwn(obj, key) проверяет, принадлежит ли свойство самому объекту, а не его прототипу. Метод появился в ES2022 и заменяет громоздкий Object.prototype.hasOwnProperty.call(obj, key). Он безопасен для объектов с null-прототипом и для ключей, которые перекрывают hasOwnProperty.
Отличить своё свойство от унаследованного
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).
Не зависеть от перекрытого метода
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.