CKTIS / JavaScript
Object.getOwnPropertyDescriptors — Deskriptoren eigener Eigenschaften
Bei einem gewöhnlichen Objekt gibt Object.getOwnPropertyDescriptors die Deskriptoren aller eigenen Eigenschaften zurück, auch für nicht aufzählbare Eigenschaften und Eigenschaften mit Symbol-Schlüsseln. Damit lassen sich Attribute untersuchen und Eigenschaften kopieren, ohne Accessoren in Werte umzuwandeln.
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.getOwnPropertyDescriptors(obj)Object.getOwnPropertyDescriptors(obj) gibt ein neues gewöhnliches Objekt zurück. Die Methode ruft von obj die Liste der Schlüssel eigener Eigenschaften ab und übernimmt für jeden aufgeführten Schlüssel den zugehörigen Deskriptor, sofern obj einen meldet. Sie berücksichtigt Zeichenketten- und Symbol-Schlüssel, auch bei nicht aufzählbaren Eigenschaften; geerbte Eigenschaften werden ausgeschlossen.
Ein Deskriptor für eine Dateneigenschaft enthält value, writable, enumerable und configurable. Ein Accessor-Deskriptor enthält statt value und writable die Felder get und set; eine fehlende Funktion wird als undefined dargestellt. Das Lesen der Deskriptoren eines gewöhnlichen Objekts ruft dessen Getter nicht auf. Bei einem Proxy können jedoch Traps ausgeführt werden und Ausnahmen auftreten. Das Ergebnis kann auch ohne Ausnahme unvollständig sein: Der ownKeys-Trap kann den Schlüssel einer konfigurierbaren eigenen Eigenschaft eines erweiterbaren Zielobjekts auslassen, selbst wenn der Proxy für diesen Schlüssel weiterhin einen Deskriptor für eine eigene Eigenschaft meldet. Die Methode lässt diesen Deskriptor dann im Ergebnis weg.
Bei einem gewöhnlichen Objekt erstellt das Muster Object.create(Object.getPrototypeOf(obj), Object.getOwnPropertyDescriptors(obj)) eine flache Kopie mit demselben Prototyp und denselben Attributen der eigenen Eigenschaften. Anders als Object.assign bleiben Accessoren und nicht aufzählbare Eigenschaften erhalten. Verschachtelte Objekte bleiben gemeinsam genutzt; dies ist keine allgemeine Klonmethode für Objekte, die von internen Slots abhängen, etwa Map.
null und undefined verursachen einen TypeError; andere primitive Werte werden in Objekte verpackt. Die Methode gehört zu ECMAScript 2017, nicht zu Web APIs. Die Unterstützung im Zielbrowser muss separat geprüft werden — die Verfügbarkeit in Node 24 beweist sie nicht.
Beispiele
let reads = 0;
const source = Object.create(null);
Object.defineProperties(source, {
hidden: { value: 7, enumerable: false },
doubled: {
get() { reads += 1; return this.hidden * 2; },
enumerable: true
}
});
const descriptors = Object.getOwnPropertyDescriptors(source);
const copy = Object.create(Object.getPrototypeOf(source), descriptors);
console.log(reads);
console.log(descriptors.hidden.value, descriptors.hidden.enumerable);
console.log(typeof descriptors.doubled.get);
console.log(copy.doubled, reads);
console.log(Object.getPrototypeOf(copy) === null);Ergebnis
0 7 false function 14 1 true
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.