CKTIS / JavaScript
Reflect — explizite Objektoperationen
Reflect stellt statische Methoden zum Lesen, Schreiben und Untersuchen von Objekten bereit. Ein boolescher Rückgabewert beim Schreiben zeigt, ob die Operation erfolgreich war, bedeutet aber nicht, dass die Methode niemals eine Ausnahme auslösen kann.
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.get(target, key[, receiver])
Reflect.set(target, key, value[, receiver])
Reflect.defineProperty(target, key, descriptor)
Reflect.ownKeys(target)Reflect ist ein integriertes ECMAScript-Objekt, keine Funktion und kein Konstruktor: Reflect() und new Reflect() lösen einen TypeError aus. Seine Methoden stellen Operationen bereit, die den internen Mechanismen von Objekten entsprechen.
Reflect.get liest eine Eigenschaft, während Reflect.set versucht, sie zu schreiben, und einen booleschen Wert statt des zugewiesenen Werts zurückgibt. Der optionale Parameter receiver ist bei beiden Methoden standardmäßig target und bestimmt den Wert von this, wenn Getter oder Setter aufgerufen werden. Reflect.ownKeys gibt alle eigenen Zeichenfolgen- und Symbolschlüssel zurück, auch nicht aufzählbare; geerbte Schlüssel werden ausgeschlossen.
Reflect.defineProperty gibt false zurück, wenn ein Objekt einen gültigen Deskriptor ablehnt, während Object.defineProperty in dieser Situation eine Ausnahme auslöst. Ein boolescher Rückgabewert garantiert nicht, dass keine Ausnahmen auftreten: Ungültige Argumente sowie Code in Gettern, Settern oder Proxy-Fallen können sie verursachen. Eigenschaftsoperationen erfordern ein Objekt als target.
Im Beispiel ist die Eigenschaft nicht aufzählbar und nicht beschreibbar. Reflect.set gibt auch im Strict-Modus false zurück, der Wert bleibt 10, und Reflect.ownKeys findet den Schlüssel weiterhin.
Beispiele
"use strict";
const target = {};
Reflect.defineProperty(target, "score", {
value: 10,
writable: false,
enumerable: false,
configurable: false
});
console.log(Reflect.get(target, "score"));
console.log(Reflect.set(target, "score", 20));
console.log(Reflect.ownKeys(target).join(","));
console.log(Reflect.get(target, "score"));Ergebnis
10 false score 10
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.