CKTIS / JavaScript
Reflect.get — eine Eigenschaft mit optionalem Receiver lesen
`Reflect.get` liest eine Eigenschaft eines Objekts, auch eine geerbte. Bei der gewöhnlichen Eigenschaftssuche wird der Receiver dem Getter als `this`-Argument übergeben, ohne den Ausgangspunkt der Suche zu ändern.
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, propertyKey[, receiver])Reflect.get(target, propertyKey[, receiver]) führt die interne [[Get]]-Operation aus. Bei einem gewöhnlichen Objekt wird die Eigenschaft zuerst in target und danach entlang der Prototypkette gesucht. Eine fehlende Eigenschaft ergibt undefined; ein Accessor ohne Getter ergibt ebenfalls undefined.
Wird receiver weggelassen, entspricht er standardmäßig target. Bei der gewöhnlichen Eigenschaftssuche wird receiver beim Aufruf eines Getters als this-Argument übergeben, auch bei einem geerbten Getter. Das bedeutet nicht, dass this im Getter mit receiver übereinstimmt. Ein gebundener Getter übergibt der zugrunde liegenden Funktion seinen gebundenen this-Wert statt des beim Aufruf übergebenen this-Arguments. Eine als Getter verwendete Pfeilfunktion ignoriert das this-Argument und verwendet das lexikalisch gebundene this, auch wenn sie außerhalb des Strict Mode definiert wurde. Bei einer Funktion außerhalb des Strict Mode, deren this nicht lexikalisch gebunden ist, wird ein this-Argument mit dem Wert null oder undefined durch den globalen this-Wert der Funktion ersetzt; andere primitive Werte werden in Objekte verpackt. Der Receiver ersetzt target nicht als Ausgangspunkt der Suche. Beim Lesen einer gewöhnlichen Dateneigenschaft wird der gefundene Wert zurückgegeben, nicht eine Eigenschaft von receiver.
target muss ein Objekt sein: Ein primitiver Wert, null oder undefined führt zu einem TypeError, statt dass der primitive Wert automatisch verpackt wird. propertyKey wird in einen Eigenschaftsschlüssel vom Typ String oder Symbol umgewandelt. Beim Lesen kann Getter-Code oder die get-Falle eines Proxy-Objekts ausgeführt werden; Reflect.get fängt Ausnahmen nicht ab.
Verwende diese Methode, wenn du den Receiver eines Getters ausdrücklich steuern musst. Das Lesen allein prüft nicht, ob eine Eigenschaft existiert: undefined kann sowohl bedeuten, dass die Eigenschaft fehlt, als auch, dass dies ihr aktueller Wert ist.
Beispiele
const prototype = {
get greeting() {
return `Hello, ${this.name}`;
}
};
const target = Object.create(prototype);
target.name = "Ada";
const receiver = { name: "Lin" };
console.log(Reflect.get(target, "greeting"));
console.log(Reflect.get(target, "greeting", receiver));
console.log(Reflect.get(target, "name", receiver));
console.log(Reflect.get(target, "missing"));Ergebnis
Hello, Ada Hello, Lin Ada undefined
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.