Object.hasOwn()
Определение и применение
Object.hasOwn() проверяет, есть ли у объекта собственное свойство с указанным ключом. Свойства прототипа
не учитываются. Метод полезен, когда значение
undefined
допустимо и нужно отличить его от отсутствующего поля.
Поддержка браузерами
Спецификация: ecma262
Поддерживается во всех основных браузерах с 2022 года.
| Возможность | Компьютеры | Мобильные | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
hasOwn | 93 | 93 | 92 | 79 | 15.4 | 93 | 92 | 66 | 15.4 | 17.0 | 93 | 15.4 |
поддерживаетсяс ограниченияминет поддержкинет данных≤31 — не позднее версии 31
Синтаксис
Object.hasOwn(object, key);
object — проверяемый объект, key — имя свойства: строка или символ. Другие ключи
преобразуются к ключу свойства. Метод вызывается у Object, а не у проверяемого объекта.
Результат и исходные данные
Возвращает true или false. Сам метод не добавляет и не удаляет свойства. Неперечислимые
свойства тоже учитываются. Значение поля не читается: обычный геттер не вызывается. У объекта-прокси проверка может
вызвать пользовательскую ловушку.
Наличие ключа и значение поля
Поле со значением undefined и отсутствующее поле:
const obj = { note: undefined };
obj.note; // undefined — поле есть
obj.missing; // undefined — поля нет
Object.hasOwn(obj, "note"); // true
Object.hasOwn(obj, "missing"); // falseСвойство прототипа учитывается в in, но не в Object.hasOwn():
const prototype = { delivery: "courier" };
const order = Object.create(prototype);
order.delivery; // "courier" — получено из прототипа
"delivery" in order; // true
Object.hasOwn(order, "delivery"); // false
В отличие от
object.hasOwnProperty(), вызов не зависит от одноимённого свойства объекта. Он подходит и для словаря, созданного через
Object.create(null). Это важно при работе с ключами, поступающими из данных.
Примитивы, кроме null и undefined, временно рассматриваются как объекты. Например, у строки
есть собственные индексы и
length. Для проверки структуры входных данных сначала убедитесь, что получили нужный тип, а затем проверяйте поля.
Исключения
| Тип исключения | Условие |
|---|---|
TypeError |
Вместо объекта переданы null или undefined. Ошибка пользовательского преобразования
ключа или ловушки Proxy также передаётся вызывающему коду.
|
Спецификация
Примеры, попробуйте сами
Своё поле, отсутствующее поле и прототип
У note есть ключ, но нет заданного значения. Добавьте missing и сравните проверки. delivery сначала принадлежит только прототипу.
index.html
<html lang="ru">
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1" />
<title>Своё поле, отсутствующее поле и прототип</title>
</head>
<body>
<p>Откройте консоль браузера, чтобы увидеть результат.</p>
<script src="main.js"></script>
</body>
</html>
main.js
const defaults = { delivery: 'courier' }
const order = Object.create(defaults)
order.note = undefined
console.log(order.note, order.missing)
console.log(Object.hasOwn(order, 'note'), Object.hasOwn(order, 'missing'))
console.log('delivery' in order, Object.hasOwn(order, 'delivery'))
Нажмите , чтобы запустить пример.
Ключ hasOwnProperty не мешает проверке
Замените имя проверяемого ключа на отсутствующее. У словаря нет прототипа, поэтому метод вызывается через Object.
index.html
<html lang="ru">
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1" />
<title>Ключ hasOwnProperty не мешает проверке</title>
</head>
<body>
<p>Откройте консоль браузера, чтобы увидеть результат.</p>
<script src="main.js"></script>
</body>
</html>
main.js
const stock = Object.create(null)
stock.hasOwnProperty = 4
stock.tea = 0
console.log(Object.hasOwn(stock, 'hasOwnProperty'))
console.log(Object.hasOwn(stock, 'tea'), Object.hasOwn(stock, 'coffee'))
Нажмите , чтобы запустить пример.