CKTIS / JavaScript
Reflect.preventExtensions — Erweiterungen eines Objekts verhindern
Reflect.preventExtensions(target) verhindert, dass einem Objekt neue eigene Eigenschaften hinzugefügt werden, und gibt einen booleschen Wert zurück. Vorhandene Eigenschaften werden dadurch nicht eingefroren; außerdem können weiterhin Ausnahmen ausgelöst werden.
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.preventExtensions(target)Reflect.preventExtensions(target) ruft die interne Operation [[PreventExtensions]] des Objekts auf. Sie gibt true zurück, wenn die Operation erfolgreich ist, andernfalls false. Das Argument muss ein Objekt sein; ein primitiver Wert, einschließlich null, führt zu einem TypeError. Ausnahmen der internen Operation werden weitergegeben – ein boolescher Rückgabewert bedeutet nicht, dass keine Ausnahmen auftreten können.
Bei einem gewöhnlichen Objekt verhindert ein Erfolg dauerhaft das Hinzufügen neuer eigener Eigenschaften, auch solcher mit Symbol-Schlüsseln. Ein erneuter Aufruf gibt true zurück. Auch das Ändern des Prototyps in einen anderen ist dann nicht möglich. Vorhandene Eigenschaften lassen sich weiterhin ändern oder löschen, sofern ihre Deskriptoren dies erlauben; verschachtelte Objekte bleiben unverändert.
Dies ist nicht gleichbedeutend mit Object.seal oder Object.freeze: Die Methode ändert weder die Attribute configurable noch writable. Object.preventExtensions gibt bei Erfolg sein Argument zurück und löst einen TypeError aus, wenn die Operation false zurückgibt; primitive Werte gibt es unverändert zurück. Reflect.preventExtensions stellt stattdessen das boolesche Ergebnis bereit und weist primitive Werte zurück.
Ein Proxy kann die Operation über seine preventExtensions-Falle abfangen. Die Falle kann sie mit der Rückgabe false ablehnen. Meldet sie jedoch Erfolg, obwohl das Zielobjekt weiterhin erweiterbar ist, führt dies zu einem TypeError. Im Beispiel zeigt Reflect.set einen fehlgeschlagenen Versuch, eine Eigenschaft hinzuzufügen, ohne vom Strict Mode abhängig zu sein.
Beispiele
const item = { count: 1 };
console.log(Reflect.preventExtensions(item));
console.log(Reflect.isExtensible(item));
console.log(Reflect.set(item, "extra", 10));
item.count = 2;
console.log(item.count);
console.log(Reflect.deleteProperty(item, "count"));
console.log(Reflect.has(item, "count"));Ergebnis
true false false 2 true false
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.