Reflect.preventExtensions()
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2016.
Die statische Methode Reflect.preventExtensions() ähnelt Object.preventExtensions(). Sie verhindert, dass jemals neue Eigenschaften zu einem Objekt hinzugefügt werden (d.h. sie verhindert zukünftige Erweiterungen des Objekts).
Probieren Sie es aus
const object = {};
console.log(Reflect.isExtensible(object));
// Expected output: true
Reflect.preventExtensions(object);
console.log(Reflect.isExtensible(object));
// Expected output: false
Syntax
Reflect.preventExtensions(target)
Parameter
target-
Das Zielobjekt, bei dem Erweiterungen verhindert werden sollen.
Rückgabewert
Ein Boolean, der angibt, ob das Ziel erfolgreich so eingestellt wurde, dass Erweiterungen verhindert werden.
Ausnahmen
TypeError-
Wird ausgelöst, wenn
targetkein Objekt ist.
Beschreibung
Reflect.preventExtensions() bietet die reflektive Semantik, um Erweiterungen eines Objekts zu verhindern. Die Unterschiede zu Object.preventExtensions() sind:
Reflect.preventExtensions()löst einenTypeErroraus, wenn das Ziel kein Objekt ist, währendObject.preventExtensions()immer nicht-objektbezogene Ziele unverändert zurückgibt.Reflect.preventExtensions()gibt einenBooleanzurück, der anzeigt, ob das Ziel erfolgreich so eingestellt wurde, dass Erweiterungen verhindert werden, währendObject.preventExtensions()das Zielobjekt zurückgibt.
Reflect.preventExtensions() ruft die [[PreventExtensions]] interne Objektmethode des targets auf.
Beispiele
Verwendung von Reflect.preventExtensions()
Siehe auch Object.preventExtensions().
// Objects are extensible by default.
const empty = {};
Reflect.isExtensible(empty); // true
// … but that can be changed.
Reflect.preventExtensions(empty);
Reflect.isExtensible(empty); // false
Unterschied zu Object.preventExtensions()
Wenn das target-Argument dieser Methode kein Objekt ist (ein primitiver Wert), wird ein TypeError verursacht. Mit Object.preventExtensions() wird ein nicht-objektbezogenes target unverändert zurückgegeben, ohne Fehlermeldung.
Reflect.preventExtensions(1);
// TypeError: 1 is not an object
Object.preventExtensions(1);
// 1
Spezifikationen
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-reflect.preventextensions |
Browser-Kompatibilität
Loading…