Object.getOwnPropertyDescriptors()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Die statische Methode Object.getOwnPropertyDescriptors() gibt alle eigenen Property-Deskriptoren eines gegebenen Objekts zurück.

Probieren Sie es aus

const object1 = {
  property1: 42,
};

const descriptors1 = Object.getOwnPropertyDescriptors(object1);

console.log(descriptors1.property1.writable);
// Expected output: true

console.log(descriptors1.property1.value);
// Expected output: 42

Syntax

js
Object.getOwnPropertyDescriptors(obj)

Parameter

obj

Das Objekt, für das alle eigenen Property-Deskriptoren abgerufen werden sollen.

Rückgabewert

Ein Objekt, das alle eigenen Property-Deskriptoren des Objekts enthält. Es kann ein leeres Objekt sein, wenn keine Eigenschaften vorhanden sind.

Beschreibung

Diese Methode ermöglicht die genaue Untersuchung der Beschreibung aller eigenen Eigenschaften eines Objekts. Eine Eigenschaft in JavaScript besteht entweder aus einem string-basierten Namen oder einem Symbol und einem Property-Deskriptor. Weitere Informationen über die Typen und Attribute von Property-Deskriptoren finden Sie in Object.defineProperty().

Ein Property-Deskriptor ist ein Datensatz mit einigen der folgenden Attribute:

value

Der mit der Eigenschaft verknüpfte Wert (nur Daten-Deskriptoren).

writable

true, wenn und nur wenn der Wert, der mit der Eigenschaft verknüpft ist, geändert werden kann (nur Daten-Deskriptoren).

get

Eine Funktion, die als Getter für die Eigenschaft dient, oder undefined, wenn kein Getter vorhanden ist (nur Accessor-Deskriptoren).

set

Eine Funktion, die als Setter für die Eigenschaft dient, oder undefined, wenn kein Setter vorhanden ist (nur Accessor-Deskriptoren).

configurable

true, wenn und nur wenn der Typ dieses Property-Deskriptors geändert werden kann und die Eigenschaft aus dem entsprechenden Objekt gelöscht werden kann.

enumerable

true, wenn und nur wenn diese Eigenschaft bei der Aufzählung der Eigenschaften des entsprechenden Objekts angezeigt wird.

Beispiele

Erstellen einer flachen Kopie

Während die Methode Object.assign() nur aufzählbare und eigene Eigenschaften von einem Quellobjekt auf ein Zielobjekt kopiert, können Sie diese Methode und Object.create() für eine flache Kopie zwischen zwei unbekannten Objekten verwenden:

js
Object.create(
  Object.getPrototypeOf(obj),
  Object.getOwnPropertyDescriptors(obj),
);

Erstellen einer Unterklasse

Ein typischer Weg, eine Unterklasse zu erstellen, besteht darin, die Unterklasse zu definieren, ihren Prototyp auf eine Instanz der Oberklasse zu setzen und dann Eigenschaften auf dieser Instanz zu definieren. Dies kann insbesondere bei Gettern und Settern umständlich werden. Stattdessen können Sie diesen Code verwenden, um den Prototyp festzulegen:

js
function superclass() {}
superclass.prototype = {
  // Define the superclass constructor, methods, and properties here
};
function subclass() {}
subclass.prototype = Object.create(superclass.prototype, {
  // Define the subclass constructor, methods, and properties here
});

Spezifikationen

Specification
ECMAScript® 2025 Language Specification
# sec-object.getownpropertydescriptors

Browser-Kompatibilität

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
Node.js
getOwnPropertyDescriptors

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support

Siehe auch