Object.isExtensible()

Статический метод Object.isExtensible() определяет, является ли объект расширяемым (т. е. можно ли к нему добавлять новые свойства).

Попробуйте

const object = {};

console.log(Object.isExtensible(object));
// Expected output: true

Object.preventExtensions(object);

console.log(Object.isExtensible(object));
// Expected output: false

Синтаксис

Object.isExtensible(obj)

Параметры

obj

Объект, который нужно проверить.

Возвращаемое значение

Boolean, указывающий, является ли данный объект расширяемым.

Описание

Объекты по умолчанию являются расширяемыми: к ним можно добавлять новые свойства, а их [[Prototype]] можно переназначать. Объект можно пометить как нерасширяемый с помощью одного из методов: Object.preventExtensions(), Object.seal(), Object.freeze() или Reflect.preventExtensions().

Примеры

Использование Object.isExtensible

// New objects are extensible.
const empty = {};
Object.isExtensible(empty); // true

// They can be made un-extensible
Object.preventExtensions(empty);
Object.isExtensible(empty); // false

// Sealed objects are by definition non-extensible.
const sealed = Object.seal({});
Object.isExtensible(sealed); // false

// Frozen objects are also by definition non-extensible.
const frozen = Object.freeze({});
Object.isExtensible(frozen); // false

Аргумент не является объектом

В ES5, если аргумент этого метода не является объектом (примитив), это вызовет TypeError. В ES2015, если передан аргумент не являющийся объектом, метод вернет false без каких-либо ошибок, поскольку примитивы по определению неизменяемы.

Object.isExtensible(1);
// TypeError: 1 is not an object (ES5 code)

Object.isExtensible(1);
// false                         (ES2015 code)

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

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

См. также

• Object.preventExtensions()
• Object.seal()
• Object.isSealed()
• Object.freeze()
• Object.isFrozen()
• Reflect.isExtensible()