Объект, в котором будет создаваться или настраиваться свойство.
имя Имя создаваемого или настраиваемого свойства.
дескриптор Объект дескриптора свойства, описывающий новое свойство или изменения, которые должны быть выполнены в существующем свойстве.
Возвращаемое значение
Объект о.
Исключения
ТуреЕrror
Генерируется, если аргумент о не является объектом или если свойство не может быть создано (из-за того, что объект о является нерасширяемым) или настроено (например, из-за того, что уже существующее свойство является ненастраиваемым). Перечень ошибок, которые могут вызвать исключение
ТуреЕrror
, приводится в разделе 6.7.
Описание
Функция
Object.defineProperty
создает или настраивает свойство с именем имя в объекте о, используя описание свойства в аргументе дескриптор. Дополнительные сведения об объектах дескрипторов свойств приводятся в справочной статье Object.getOwnPropertyDescriptor.
Если объект о еще не имеет свойства с именем имя, эта функция просто создаст новое свойство с атрибутами и значением, указанными в дескрипторе. Если в дескрипторе не указаны какие-либо атрибуты, соответствующие им атрибуты получат значение false или undefined.
Если значение аргумента имя совпадает с именем существующего свойства объекта о, то функция
Object.defineProperty
настроит это свойство, изменив его значение или атрибуты. В этом случае в дескрипторе достаточно указать только атрибуты, которые должны быть изменены: атрибуты, отсутствующие в дескрипторе, сохранят свои прежние значения.
Обратите внимание, что эта функция вызывается не как метод объекта: это глобальная функция, которая принимает объект в виде аргумента.
Пример
function constant(o, n, v) { // Определить константу о.n со значением v
Object.defineProperty(o, n, { value: v, writable: false
enumerable: true, configurable:false});
}
См. также
Object.create, Object.defineProperties, Object.getOwnPropertyDescriptor, раздел 6.7
Object.freeze (ECMAScript 5)
делает объект неизменяемым
Синтаксис
Object.freeze(o)
Аргументы
о Объект, который должен быть зафиксирован.
Возвращаемое значение
Зафиксированный объект о.
Описание
Функция
Object.freeze
делает объект о нерасширяемым (
Object.preventExtensions
), а все его собственные свойства - ненастраиваемыми, подобно функции
Object.seal.
Однако в дополнение к этому она делает все неунаследованные свойства доступными только для чтения. Это означает, что в объект о нельзя будет добавлять новые свойства, а существующие свойства-данные нельзя будет изменить или удалить. Действие функции
Object.freeze
является необратимым, т.е. зафиксированный объект нельзя снова сделать доступным для изменения.
Имейте в виду, что функция
Object.freeze
устанавливает атрибут writable, имеющийся только в свойствах-данных. Она не действует на свойства, имеющие методы записи. Отметьте также, что функция
Object.freeze
не действует на унаследованные свойства. Обратите внимание, что эта функция вызывается не как метод объекта: это глобальная функция, которая принимает объект в виде аргумента.
См. также
Object.defineProperty, Object.isFrozen, Object.preventExtensions, Object.seal, раздел 6.8.3
Object.getOwnPropertyDescriptor (ECMAScript 5)
возвращает атрибуты свойства
Синтаксис
Object.getOwnPropertyDescriptor(o, имя)
Аргументы
о Объект, которому принадлежит искомое свойство.
имя Имя свойства (или индекс элемента массива), атрибуты которого требуется получить.
Возвращаемое значение
Объект дескриптора для указанного свойства заданного объекта или undefined, если такое свойство не существует.
Описание
Функция
Object.getOwnPropertyDescriptor
возвращает дескриптор для указанного свойства заданного объекта. Дескриптор свойства - это объект, описывающий атрибуты и значение свойства. Более полная информация приводится в следующем подразделе. Обратите внимание, что эта функция вызывается не как метод объекта: это глобальная функция, которая принимает объект в виде аргумента.
Дескрипторы свойств
Дескриптор свойства - это обычный JavaScript-объект, описывающий атрибуты (и иногда значение) свойства. В языке JavaScript существует два типа свойств. Свойства-данные, имеющие значение и три атрибута:
enumerable, writable
и
configurable
. Свойства с методами доступа, имеющие метод чтения и/или метод записи, а также атрибуты
enumerable
и
configurable
.
Дескриптор свойства с данными имеет следующий вид:
{
value: /* любое значение, допустимое в языке JavaScript */,
writable: /* true или false */,
enumerable: /* true или false */,
configurable: /* true или false */
}
Дескриптор свойства с методами доступа имеет следующий вид: