Object.prototype.hasOwnProperty()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since июль 2015 г..

Сводка

Метод hasOwnProperty() возвращает логическое значение, указывающее, содержит ли объект указанное свойство.

Синтаксис

obj.hasOwnProperty(prop)

Каждый объект, произошедший от Object, наследует метод hasOwnProperty. Этот метод может использоваться для определения того, содержит ли объект указанное свойство в качестве собственного свойства объекта; в отличие от оператора in, этот метод не проверяет существование свойств в цепочке прототипов объекта.

Примеры

Пример: использование hasOwnProperty для проверки существования свойства

В следующем примере определяется, содержит ли объект o свойство с именем prop:

js
o = new Object();
o.prop = "существует";

function changeO() {
  o.newprop = o.prop;
  delete o.prop;
}

o.hasOwnProperty("prop"); // вернёт true
changeO();
o.hasOwnProperty("prop"); // вернёт false

Пример: собственные и унаследованные свойства

Следующий пример показывает разницу между собственными свойствами и свойствами, унаследованными через цепочку прототипов:

js
o = new Object();
o.prop = "существует";
o.hasOwnProperty("prop"); // вернёт true
o.hasOwnProperty("toString"); // вернёт false
o.hasOwnProperty("hasOwnProperty"); // вернёт false

Пример: обход свойств объекта

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

js
var buz = {
  fog: "stack",
};

for (var name in buz) {
  if (buz.hasOwnProperty(name)) {
    alert("это точно туман (" + name + "). Значение: " + buz[name]);
  } else {
    alert(name); // toString или что-то ещё
  }
}

Пример: hasOwnProperty как свойство

JavaScript не защищает имя свойства hasOwnProperty; таким образом, вполне может существовать объект с таким свойством, поэтому для получения правильного результата нужно использовать внешний метод hasOwnProperty:

js
var foo = {
  hasOwnProperty: function () {
    return false;
  },
  bar: "Тут драконы",
};

foo.hasOwnProperty("bar"); // всегда возвращает false

// Используем метод hasOwnProperty другого объекта и вызываем его с передачей foo в качестве this
({}).hasOwnProperty.call(foo, "bar"); // true

// Также для этих целей можно использовать свойство hasOwnProperty из прототипа Object
Object.prototype.hasOwnProperty.call(foo, "bar"); // true

Обратите внимание, что в последнем случае новые объекты не создаются.

Help improve MDN

Was this page helpful to you?

Yes No

Learn how to contribute

This page was last modified on 24 мар. 2025 г. by MDN contributors.

View this page on GitHub • Report a problem with this content

Стандартные встроенные объекты
Object
Конструктор
1. Object()
Статические методы
Методы экземпляра
Свойства экземпляра
1. Object.prototype.__proto__
2. Object.prototype.constructor
Наследование
Object/Function
Статические методы
Статические свойства
Методы экземпляра
Свойства экземпляра
1. Object.prototype.__proto__
2. Object.prototype.constructor

Object.prototype.hasOwnProperty()

Сводка

In this article

Синтаксис

Параметры

Описание

Примеры

Пример: использование hasOwnProperty для проверки существования свойства

Пример: собственные и унаследованные свойства

Пример: обход свойств объекта

Пример: hasOwnProperty как свойство

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

Совместимость с браузерами

Смотрите также

Help improve MDN