JavaScript. Подробное руководство, 6-е издание, стр. 70

Методы получения и записи значений атрибутов свойств, предусмотренные стандартом ECMAScript 5, используют объект, называемый дескриптором свойства (

property descriptor

), представляющий множество из четырех атрибутов. Объект дескриптора свойства обладает свойствами, имена которых совпадают с именами атрибутов свойства, которое он описывает. То есть объекты-дескрипторы свойств с данными имеют свойства с именами

value

writable

enumerable

configurable

. А дескрипторы свойств с методами доступа вместо свойств

value

writable

имеют свойства

get

set

. Свойства

writable

enumerable

configurable

являются логическими значениями, а свойства

get

set

- функциями.

Получить дескриптор свойства требуемого объекта можно вызовом

Object.get-OwnPropertyDescriptor():

// Вернет {value: 1, writable:true, enumerable:true, configurable:true}

Object.getOwnPropertyDescriptor({x:1}, "x");

// Теперь получим свойство octet объекта random, объявленного выше.

// Вернет { get: /*func*/. set:undefined, enumerable:true, configurable:true}

Object.getOwnPropertyDescriptor(random, "octet");

// Вернет undefined для унаследованных и несуществующих свойств. 

Object.getOwnPropertyDescriptor({}, "х"); // undefined, нет такого свойства

Object.getOwnPropertyDescriptor({}, "toString"); // undefined, унаследованное

Как можно заключить из названия метода,

Object.getOwnPropertyDescriptor()

работает только с собственными свойствами. Чтобы получить атрибуты унаследованного свойства, необходимо явно выполнить обход цепочки прототипов (смотрите описание

Object.getPrototypeOf()

в разделе 6.8.1).

Чтобы изменить значение атрибута свойства или создать новое свойство с заданными значениями атрибутов, следует вызвать метод

Object.defineProperty()

, передав ему объект, в котором требуется выполнить изменения, имя создаваемого или изменяемого свойства и объект дескриптора свойства:

var о = {}; // Создать пустой объект без свойств

// Создать неперечислимое простое свойство х со значением 1.

Object.defineProperty(o, "х", { value : 1,

 writable: true, enumerable: false, configurable: true}):

// Убедиться, что свойство создано и является неперечислимым 

о.х; // => 1

Object.keys(o) // => []

// Теперь сделать свойство х доступным только для чтения 

Object.defineProperty(o, "х", { writable: false });

// Попытаться изменить значение свойства

о.х = 2; // Неудача, в строгом режиме возбудит ТуреЕrror

Дескриптор свойства, передаваемый методу

Object.defineProperty(),

необязательно должен иметь все четыре атрибута. При создании нового свойства отсутствующие атрибуты получат значение

false

или

undefined

. При изменении существующего свойства для отсутствующих атрибутов будут сохранены текущие значения. Обратите внимание, что этот метод изменяет существующее собственное свойство или создает новое собственное свойство - он не изменяет унаследованные свойства.

Если возникнет необходимость создать или изменить сразу несколько свойств, можно воспользоваться методом

Object.defineProperties().

Первым аргументом ему передается объект, который требуется изменить. Вторым аргументом - объект, отображающий имена создаваемых или модифицируемых свойств в дескрипторы этих свойств. Например:

var р = Object.defineProperties({},{

 х:{ 

 value: 1, 

 writable: true,

 enumerable:true, 

 configurable:true 

 }, 

 y:{ 

 value: 1,

 writable: true,

 enumerable:true,

 configurable:true },

 r:{

 get: function() { return Math.sqrt(this.x*this.x + this.y*this.y) },

 enumerable:true,

 configurable:true

 }

});

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

Object.defineProperties()

возвращает модифицированный объект (подобно методу

Object.defineProperty()