WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Reflect.getOwnPropertyDescriptor – eine eigene Eigenschaft untersuchen

Reflect.getOwnPropertyDescriptor(target, key) gibt den Deskriptor einer eigenen Eigenschaft oder undefined zurück. Damit lassen sich Wert, Zugriffsfunktionen und Attribute einer Eigenschaft untersuchen, ohne die Prototypenkette zu durchsuchen.

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.getOwnPropertyDescriptor(target, key)

Reflect.getOwnPropertyDescriptor(target, key) beschreibt nur eine eigene Eigenschaft von target, auch wenn sie nicht aufzählbar ist. Es gibt ein neues Deskriptorobjekt oder undefined zurück, wenn die Eigenschaft keine eigene Eigenschaft ist. Eine geerbte Eigenschaft wird nicht in der Prototypenkette gesucht; auch eine eigene Eigenschaft mit dem Wert undefined hat weiterhin einen Deskriptor.

Ein Datendeskriptor enthält value, writable, enumerable und configurable. Ein Zugriffsfunktionen-Deskriptor enthält statt value und writable die Felder get und set; deren Werte sind Funktionen oder undefined. Das Untersuchen des Deskriptors eines gewöhnlichen Objekts ruft dessen Getter nicht auf. Änderungen am zurückgegebenen Deskriptor definieren die Eigenschaft nicht selbst neu; verwenden Sie dafür etwa Object.defineProperty.

target muss ein Objekt sein; jeder primitive Wert, einschließlich null und undefined, verursacht einen TypeError. Das unterscheidet sich von Object.getOwnPropertyDescriptor, das primitive Werte außer null und undefined umschließt. Die Operation ToPropertyKey wandelt key in einen Eigenschaftsschlüssel um. Ist key ein Objekt, wandelt die Operation es zunächst in einen primitiven Wert um, etwa durch Aufruf seiner Methode Symbol.toPrimitive. Ist der primitive Wert ein Symbol, bleibt er als Schlüssel erhalten; andernfalls wird er in eine Zeichenfolge umgewandelt.

Gehen Sie nicht davon aus, dass der Vorgang immer frei von Seiteneffekten ist: Die Umwandlung von key kann benutzerdefinierten Code ausführen, und ein Proxy kann seine getOwnPropertyDescriptor-Falle auslösen. Dabei entstehende Ausnahmen werden an den Aufrufer weitergegeben. Das Beispiel zeigt, dass eine geerbte Eigenschaft ignoriert wird und dass eine Änderung von descriptor.value item.score nicht ändert.

Beispiele

const item = Object.create({ inherited: 1 });
Object.defineProperty(item, "score", {
  value: 42,
  writable: false,
  enumerable: true,
  configurable: true
});

const descriptor = Reflect.getOwnPropertyDescriptor(item, "score");
console.log(JSON.stringify(descriptor));
console.log(Reflect.getOwnPropertyDescriptor(item, "inherited"));
descriptor.value = 99;
console.log(item.score);

Ergebnis

{"value":42,"writable":false,"enumerable":true,"configurable":true}
undefined
42

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.

Quellen