WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Object.isExtensible: ob ein Objekt neue Eigenschaften annimmt

Object.isExtensible liefert einen Boolean, der angibt, ob dem Objekt noch neue eigene Eigenschaften hinzugefügt werden können.

Version: ECMAScript 5 onward; primitives return false since ECMAScript 2015; example target: Node.js 24.22.2

Syntax

Object.isExtensible(obj)

Object.isExtensible(obj) ruft die interne Methode [[IsExtensible]] eines Objekts auf und liefert deren Boolean. Ein neues gewöhnliches Objekt ist erweiterbar. Object.preventExtensions, Object.seal und Object.freeze setzen den Zustand auf false; bei gewöhnlichen Objekten lässt er sich nicht wiederherstellen.

Nicht-Erweiterbarkeit verhindert neue eigene Eigenschaften, friert vorhandene aber nicht allein ein. Eine vorhandene schreibbare Eigenschaft kann ihren Wert ändern, eine konfigurierbare kann gelöscht oder im Rahmen ihres Deskriptors umgestaltet werden. false ist daher weder gleichbedeutend mit Object.isSealed noch mit Object.isFrozen.

Die Methode existiert seit ECMAScript 5; seit ECMAScript 2015 liefern alle Primitive einfach false, statt zu werfen. Bei Proxy kann die isExtensible-Falle laufen, deren Ergebnis zu Boolean wird. Es muss der wirklichen Erweiterbarkeit des Ziels entsprechen, sonst entsteht TypeError; eine Ausnahme der Falle wird ebenfalls weitergereicht.

Beispiele

const open = { value: 1 };
const closed = Object.preventExtensions({ value: 1 });

console.log(Object.isExtensible(open), Object.isExtensible(closed));
closed.value = 2;
console.log(closed.value, Reflect.defineProperty(closed, "extra", { value: 3 }));
console.log(Object.isExtensible(7));

const proxy = new Proxy(closed, { isExtensible() { return true; } });
try { Object.isExtensible(proxy); } catch (error) { console.log(error.name); }

Ergebnis

true false
2 false
false
TypeError

Das Beispiel vergleicht offene und geschlossene Objekte, ändert einen vorhandenen Wert, verwirft eine neue Eigenschaft und zeigt eine Proxy-Invariante.

Quellen