Reflect.getOwnPropertyDescriptor()
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit September 2016 browserübergreifend verfügbar.
Die statische Methode Reflect.getOwnPropertyDescriptor() ähnelt Object.getOwnPropertyDescriptor(). Sie gibt einen Eigenschaftsdeskriptor für die angegebene Eigenschaft zurück, wenn diese auf dem Objekt vorhanden ist, andernfalls undefined.
Probieren Sie es aus
const object = {
property1: 42,
};
console.log(Reflect.getOwnPropertyDescriptor(object, "property1").value);
// Expected output: 42
console.log(Reflect.getOwnPropertyDescriptor(object, "property2"));
// Expected output: undefined
console.log(Reflect.getOwnPropertyDescriptor(object, "property1").writable);
// Expected output: true
Syntax
Reflect.getOwnPropertyDescriptor(target, propertyKey)
Parameter
target-
Das Zielobjekt, in dem nach der Eigenschaft gesucht wird.
propertyKey-
Der Name der Eigenschaft, deren eigener Eigenschaftsdeskriptor abgerufen werden soll.
Rückgabewert
Ein Eigenschaftsdeskriptor-Objekt, wenn die Eigenschaft eine eigene Eigenschaft von target ist; andernfalls undefined.
Ausnahmen
TypeError-
Wird ausgelöst, wenn
targetkein Objekt ist.
Beschreibung
Reflect.getOwnPropertyDescriptor() bietet die reflektive Semantik zum Abrufen des Eigenschaftsdeskriptors eines Objekts. Der einzige Unterschied zu Object.getOwnPropertyDescriptor() besteht darin, wie mit Zielwerten umgegangen wird, die keine Objekte sind. Reflect.getOwnPropertyDescriptor() löst einen TypeError aus, wenn das Ziel kein Objekt ist, während Object.getOwnPropertyDescriptor() den Wert in ein Objekt umwandelt.
Reflect.getOwnPropertyDescriptor() ruft die objektinterne Methode [[GetOwnProperty]] von target auf.
Beispiele
Reflect.getOwnPropertyDescriptor() verwenden
Reflect.getOwnPropertyDescriptor({ x: "hello" }, "x");
// {value: "hello", writable: true, enumerable: true, configurable: true}
Reflect.getOwnPropertyDescriptor({ x: "hello" }, "y");
// undefined
Reflect.getOwnPropertyDescriptor([], "length");
// {value: 0, writable: true, enumerable: false, configurable: false}
Unterschied zu Object.getOwnPropertyDescriptor()
Wenn das Argument target dieser Methode kein Objekt ist (sondern ein primitiver Wert), wird ein TypeError ausgelöst. Bei Object.getOwnPropertyDescriptor wird ein erstes Argument, das kein Objekt ist, zunächst in ein Objekt umgewandelt.
Reflect.getOwnPropertyDescriptor("foo", 0);
// TypeError: "foo" is not non-null object
Object.getOwnPropertyDescriptor("foo", 0);
// { value: "f", writable: false, enumerable: true, configurable: false }
Spezifikationen
| Spezifikation |
|---|
| ECMAScript® 2027 Language Specification # sec-reflect.getownpropertydescriptor |