WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Object.getOwnPropertyDescriptor — eine eigene Eigenschaft untersuchen

Object.getOwnPropertyDescriptor gibt eine Beschreibung einer eigenen Objekteigenschaft zurück: ihren Wert oder ihre Zugriffsfunktionen sowie ihre Attributflags. Die Prototypkette wird nicht durchsucht; fehlt die eigene Eigenschaft, wird undefined zurückgegeben.

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

Object.getOwnPropertyDescriptor(obj, key)

Object.getOwnPropertyDescriptor(obj, key) liest den Deskriptor einer einzelnen eigenen Eigenschaft, auch wenn sie nicht aufzählbar ist. Prototypen werden nicht durchsucht. Das Ergebnis ist ein neues Deskriptorobjekt oder undefined, wenn sich die Eigenschaft nicht direkt in obj befindet. Auch eine vorhandene Eigenschaft mit dem Wert undefined hat weiterhin einen Deskriptor.

Ein Daten-Eigenschaftsdeskriptor enthält value, writable, enumerable und configurable. Ein Deskriptor einer Zugriffseigenschaft enthält anstelle von value und writable die Felder get und set; eine fehlende Zugriffsfunktion hat den Wert undefined. Bei einem gewöhnlichen Objekt ruft das Lesen des Deskriptors den Getter nicht auf. writable bestimmt, ob eine Zuweisung den Wert ändern kann, enumerable, ob die Eigenschaft bei einer Aufzählung berücksichtigt wird, und configurable, ob sie gelöscht oder neu konfiguriert werden kann.

Änderungen an den Feldern des zurückgegebenen Objekts ändern die ursprüngliche Eigenschaft nicht. Um einen Deskriptor anzuwenden, verwende Object.defineProperty und beachte dabei die Einschränkungen der bestehenden Eigenschaft. Der Deskriptor ist keine tiefe Kopie: Ein in value gespeichertes Objekt bleibt dieselbe Referenz.

key wird in einen Eigenschaftsschlüssel umgewandelt: einen String oder ein Symbol. Wird null oder undefined als obj übergeben, wird ein TypeError ausgelöst; andere primitive Werte werden in Objekte verpackt. Bei einem Proxy kann der Vorgang die getOwnPropertyDescriptor-Falle aufrufen und daher Nebenwirkungen haben oder eine Ausnahme auslösen.

Beispiele

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

const descriptor = Object.getOwnPropertyDescriptor(obj, "score");
console.log(descriptor.value, descriptor.writable);
console.log(descriptor.enumerable, descriptor.configurable);
descriptor.value = 99;
console.log(obj.score);
console.log(Object.getOwnPropertyDescriptor(obj, "inherited"));

Ergebnis

42 false
true true
42
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.

Quellen