Object.isExtensible()

Die Methode Object.isExtensible() bestimmt, ob ein Objekt erweiterbar ist. Das heißt, es können dem Objekt neue Eigenschaften hinzugefügt werden.

Object.isExtensible(obj)

obj

Das Objekt, das überprüft werden soll.

Ein Boolean, der angibt, ob das übergebene Objekt erweiterbar ist.

Standardmäßig sind Objekte erweiterbar: Es ist möglich, ihnen neue Eigenschaften zuzuweisen und sie dadurch zu verändern. In Engines, die __proto__ unterstützen, kann auch deren __proto__ Eigenschaft geändert werden. Ein Objekt kann mittels Object.preventExtensions() (en-US), Object.seal() (en-US) oder Object.freeze() explizit als nicht-erweiterbar markiert werden.

// Neue Objekte sind erweiterbar.
var empty = {};
Object.isExtensible(empty); // === true

// ...aber das kann sich ändern.
Object.preventExtensions(empty);
Object.isExtensible(empty); // === false

// Versiegelte Objekte sind per Definition nicht erweiterbar.
var sealed = Object.seal({});
Object.isExtensible(sealed); // === false

// Eingefrorene Objekte sind ebenfalls per Definition nicht erweiterbar.
var frozen = Object.freeze({});
Object.isExtensible(frozen); // === false

In ES5 muss das Argument der Methode ein echtes Objekt sein. Ist dies nicht der Fall, wird ein TypeError geworfen. In ES2015 hingegen wird ein Nicht-Objekt einfach als nicht-erweiterbares Objekt behandelt, sodass von der Methode false zurückgegeben wird.

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

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

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