Reflect.defineProperty()
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 Reflect.defineProperty() statische Methode ist wie Object.defineProperty(), gibt aber ein Boolean zurück.
Probieren Sie es aus
const object = {};
if (Reflect.defineProperty(object, "foo", { value: 42 })) {
console.log("foo created!");
// Expected output: "foo created!"
} else {
console.log("problem creating foo");
}
console.log(object.foo);
// Expected output: 42
Syntax
Reflect.defineProperty(target, propertyKey, attributes)
Parameter
target-
Das Zielobjekt, auf dem die Eigenschaft definiert werden soll.
propertyKey-
Der Name der zu definierenden oder zu ändernden Eigenschaft.
attributes-
Die Attribute für die zu definierende oder zu ändernde Eigenschaft.
Rückgabewert
Ein Boolean, der anzeigt, ob die Eigenschaft erfolgreich definiert wurde oder nicht.
Ausnahmen
TypeError-
Wird ausgelöst, wenn
targetoderattributeskein Objekt ist.
Beschreibung
Reflect.defineProperty() bietet die reflektive Semantik, eine eigene Eigenschaft in einem Objekt zu definieren. Auf sehr niedrigem Niveau gibt das Definieren einer Eigenschaft einen Boolean zurück (wie es bei dem Proxy-Handler der Fall ist). Object.defineProperty() bietet nahezu die gleiche Semantik, wirft jedoch einen TypeError, wenn der Status false ist (die Operation war nicht erfolgreich), während Reflect.defineProperty() den Status direkt zurückgibt.
Viele eingebettete Operationen würden ebenfalls eigene Eigenschaften auf Objekten definieren. Der bedeutendste Unterschied zwischen dem Definieren von Eigenschaften und dem Setzen von ihnen ist, dass Setter nicht aufgerufen werden. Zum Beispiel definieren Klassenfelder direkt Eigenschaften auf der Instanz, ohne Setter aufzurufen.
class B extends class A {
set a(v) {
console.log("Setter called");
}
} {
a = 1; // Nothing logged
}
Reflect.defineProperty() ruft die [[DefineOwnProperty]] objektinterne Methode von target auf.
Beispiele
Verwendung von Reflect.defineProperty()
const obj = {};
Reflect.defineProperty(obj, "x", { value: 7 }); // true
console.log(obj.x); // 7
Überprüfen, ob die Eigenschaftsdefinition erfolgreich war
Mit Object.defineProperty(), das ein Objekt zurückgibt, falls erfolgreich, oder einen TypeError auslöst, andernfalls würden Sie einen try...catch-Block verwenden, um Fehler abzufangen, die beim Definieren einer Eigenschaft auftreten.
Da Reflect.defineProperty() einen Boolean-Erfolgsstatus zurückgibt, können Sie hier einfach einen if...else-Block verwenden:
if (Reflect.defineProperty(target, property, attributes)) {
// success
} else {
// failure
}
Spezifikationen
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-reflect.defineproperty |