Object.prototype.propertyIsEnumerable()

Сводка

Метод propertyIsEnumerable() возвращает логическое значение, указывающее, является ли указанное свойство перечисляемым.

Синтаксис

obj.propertyIsEnumerable(prop)

Параметры

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

Описание

Каждый объект имеет метод propertyIsEnumerable. Этот метод может определять, является ли указанное свойство в объекте перечисляемым в цикле for...in, за исключением свойств, унаследованных из цепочки прототипов. Если объект не имеет указанного свойства, метод вернёт false.

Примеры

Пример: базовое использование propertyIsEnumerable

Следующий пример показывает использование метода propertyIsEnumerable на объектах и массивах:

var o = {};
var a = [];
o.prop = 'перечисляемое';
a[0] = 'перечисляемое';

o.propertyIsEnumerable('prop');   // вернёт true
a.propertyIsEnumerable(0);        // вернёт true

Пример: определённые пользователем и встроенные объекты

Следующий пример демонстрирует перечисляемость свойств, определённых пользователем и встроенных свойств:

var a = ['перечисляемое'];

a.propertyIsEnumerable(0);          // вернёт true
a.propertyIsEnumerable('length');   // вернёт false

Math.propertyIsEnumerable('random');   // вернёт false
this.propertyIsEnumerable('Math');     // вернёт false

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

var a = [];
a.propertyIsEnumerable('constructor');         // вернёт false

function firstConstructor() {
  this.property = 'не перечисляемое';
}

firstConstructor.prototype.firstMethod = function() {};

function secondConstructor() {
  this.method = function method() { return 'перечисляемый'; };
}

secondConstructor.prototype = new firstConstructor;
secondConstructor.prototype.constructor = secondConstructor;

var o = new secondConstructor();
o.arbitraryProperty = 'перечисляемое';

o.propertyIsEnumerable('arbitraryProperty');   // вернёт true
o.propertyIsEnumerable('method');              // вернёт true
o.propertyIsEnumerable('property');            // вернёт false

o.property = 'перечисляемое';

o.propertyIsEnumerable('property');            // вернёт true

// Эти вызовы вернут false, поскольку все свойства находятся в прототипе,
// который метод propertyIsEnumerable не просматривает (даже несмотря на то,
// что последние два свойства перечисляются через цикл for...in)
o.propertyIsEnumerable('prototype');   // вернёт false (в JS 1.8.1/FF3.6)
o.propertyIsEnumerable('constructor'); // вернёт false
o.propertyIsEnumerable('firstMethod'); // вернёт false

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

Спецификация Статус Комментарии
ECMAScript 3-е издание. Стандарт Изначальное определение.
ECMAScript 5.1 (ECMA-262)
Определение 'Object.prototype.propertyIsEnumerable' в этой спецификации.
Стандарт  
ECMAScript 2015 (6th Edition, ECMA-262)
Определение 'Object.prototype.propertyIsEnumerable' в этой спецификации.
Стандарт  

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

BCD tables only load in the browser

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