Object.prototype.hasOwnProperty()

Синтаксис

obj.hasOwnProperty(prop)

Параметры

prop

Имя проверяемого свойства.

Описание

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

Примеры

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

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

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

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

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

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

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

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

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

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

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:

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

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

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

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

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

• Перечисляемость и собственность свойств
• Object.getOwnPropertyNames()
• for...in
• in
• Руководство по JavaScript: повторное наследование