WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Reflect.isExtensible — Erweiterbarkeit von Objekten prüfen

Reflect.isExtensible(target) prüft, ob ein Objekt erweiterbar ist. Bei einem gewöhnlichen Objekt bedeutet Erweiterbarkeit, dass neue eigene Eigenschaften hinzugefügt werden können. Die Methode gibt einen booleschen Wert zurück und löst bei primitiven Werten einen TypeError aus.

Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

Reflect.isExtensible(target)

Reflect.isExtensible(target) gibt true zurück, wenn ein Objekt erweiterbar ist, andernfalls false. Bei einem gewöhnlichen Objekt bedeutet Erweiterbarkeit, dass neue eigene Eigenschaften hinzugefügt werden können. Die Methode liest diesen Zustand aus, ändert ihn aber nicht selbst.

Object.preventExtensions(target) verhindert, dass neue eigene Eigenschaften hinzugefügt werden. Auch Object.seal(target) und Object.freeze(target) machen Objekte nicht erweiterbar, schränken sie aber zusätzlich ein. false bedeutet daher nicht, dass ein Objekt eingefroren ist: Vorhandene beschreibbare Eigenschaften können weiterhin geändert und konfigurierbare Eigenschaften weiterhin gelöscht werden. Ein gewöhnliches Objekt kann nicht wieder erweiterbar gemacht werden.

Das Argument muss ein Objekt sein; auch Arrays und Funktionen sind Objekte. Primitive Werte, einschließlich null und undefined, lösen einen TypeError aus. Das ist ein wichtiger Unterschied zu Object.isExtensible(target), das bei primitiven Werten false zurückgibt, statt einen Fehler auszulösen.

Die Methode ruft die interne Operation [[IsExtensible]] auf. Bei einem Proxy kann dadurch der isExtensible-Trap ausgeführt werden. Gehe also nicht davon aus, dass der Aufruf frei von Nebenwirkungen ist. Nach der Umwandlung in einen booleschen Wert muss das Ergebnis des Traps der tatsächlichen Erweiterbarkeit des Zielobjekts entsprechen; andernfalls tritt ein TypeError auf. Auch ein widerrufener Proxy löst einen TypeError aus.

Beispiele

const item = { count: 1 };
console.log(Reflect.isExtensible(item));

Object.preventExtensions(item);
console.log(Reflect.isExtensible(item));
console.log(Reflect.set(item, "extra", 10));

item.count = 2;
console.log(item.count);

try {
  Reflect.isExtensible(42);
} catch (error) {
  console.log(error.name);
}

Ergebnis

true
false
false
2
TypeError

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen