Object.hasOwn()

Определение и применение

Object.hasOwn() проверяет, есть ли у объекта собственное свойство с указанным ключом. Свойства прототипа не учитываются. Метод полезен, когда значение undefined допустимо и нужно отличить его от отсутствующего поля.

Поддержка браузерами

Спецификация: ecma262

Поддерживается во всех основных браузерах с 2022 года.

Показать браузеры
Совместимостьjavascript.builtins.Object.hasOwn
ВозможностьКомпьютерыМобильные
ChromeEdgeFirefoxOperaSafariChrome AndroidFirefox for AndroidOpera AndroidSafari on iOSSamsung BrowserWebView AndroidWebView on iOS
hasOwn✓93✓93✓92✓79✓15.4✓93✓92✓66✓15.4✓17.0✓93✓15.4

поддерживаетсяс ограниченияминет поддержкинет данных≤31 — не позднее версии 31

Синтаксис

JavaScript
Object.hasOwn(object, key);

object — проверяемый объект, key — имя свойства: строка или символ. Другие ключи преобразуются к ключу свойства. Метод вызывается у Object, а не у проверяемого объекта.

Результат и исходные данные

Возвращает true или false. Сам метод не добавляет и не удаляет свойства. Неперечислимые свойства тоже учитываются. Значение поля не читается: обычный геттер не вызывается. У объекта-прокси проверка может вызвать пользовательскую ловушку.

Наличие ключа и значение поля

Поле со значением undefined и отсутствующее поле:

JavaScript
const obj = { note: undefined };

obj.note;    // undefined — поле есть
obj.missing; // undefined — поля нет

Object.hasOwn(obj, "note");    // true
Object.hasOwn(obj, "missing"); // false

Свойство прототипа учитывается в in, но не в Object.hasOwn():

JavaScript
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. Для проверки структуры входных данных сначала убедитесь, что получили нужный тип, а затем проверяйте поля.

Исключения

Исключения Object.hasOwn()
Тип исключения Условие
TypeError Вместо объекта переданы null или undefined. Ошибка пользовательского преобразования ключа или ловушки Proxy также передаётся вызывающему коду.

Спецификация

ECMAScript: Object.hasOwn.

Примеры, попробуйте сами

Своё поле, отсутствующее поле и прототип

У note есть ключ, но нет заданного значения. Добавьте missing и сравните проверки. delivery сначала принадлежит только прототипу.

index.html
HTML
<!doctype 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
JavaScript
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
<!doctype 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
JavaScript
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'))