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.