Object.prototype.hasOwnProperty()

Сводка

Метод 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: повторное наследование