WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Reflect.defineProperty — Eigenschaften mit booleschem Ergebnis definieren

Reflect.defineProperty definiert oder ändert mithilfe eines Deskriptors eine eigene Eigenschaft eines Objekts. Die Methode gibt true oder false zurück, garantiert aber keinen Ablauf ohne Ausnahmen.

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.defineProperty(target, propertyKey, attributes)

Reflect.defineProperty(target, propertyKey, attributes) definiert oder ändert eine eigene Eigenschaft von target. Der Schlüssel wird in einen String oder ein Symbol umgewandelt, und attributes ist ein Deskriptorobjekt. Die Methode gibt true zurück, wenn der Vorgang erfolgreich ist, oder false, wenn die Regeln des Objekts ihn ablehnen.

Ein Datendeskriptor verwendet value und writable; ein Accessor-Deskriptor verwendet get und set. Beide können enumerable und configurable enthalten. Datenfelder dürfen nicht mit Accessor-Feldern kombiniert werden. Beim Erstellen einer Eigenschaft auf einem gewöhnlichen Objekt sind ausgelassene Flags standardmäßig false, und ein ausgelassener Datenwert ist standardmäßig undefined. Bei einem gewöhnlichen Objekt bleiben ausgelassene Felder unverändert, wenn eine vorhandene Eigenschaft geändert wird, ohne ihre Art zu wechseln. Eine konfigurierbare Eigenschaft kann von einer Daten- in eine Accessor-Eigenschaft umgewandelt werden oder umgekehrt. Nicht angegebene Felder enumerable und configurable behalten dabei ihre bisherigen Werte. Wird beispielsweise eine konfigurierbare Dateneigenschaft durch Angabe von nur get in eine Accessor-Eigenschaft umgewandelt, entfallen value und writable, und das nicht angegebene set wird auf undefined gesetzt.

Die defineProperty-Falle eines Proxys erhält ein Deskriptorobjekt, in dem ausgelassene Felder weiterhin fehlen. Sie kann auf dem Zielobjekt des Proxys eine Eigenschaft mit anderen Attributen anlegen, solange die Proxy-Invarianten eingehalten werden.

Anders als Object.defineProperty, das das Objekt zurückgibt und bei einer abgelehnten Definition einen TypeError auslöst, gibt diese Methode ein boolesches Ergebnis zurück. Sie ist jedoch nicht frei von Ausnahmen: Ein target, das kein Objekt ist, ein ungültiger Deskriptor oder eine Ausnahme bei der Schlüsselkonvertierung kann den Aufruf unterbrechen. Auch eine defineProperty-Falle eines Proxys kann eine Ausnahme auslösen.

Bei einem gewöhnlichen Objekt führt das Hinzufügen einer Eigenschaft zu einem nicht erweiterbaren Objekt oder eine unzulässige Änderung einer nicht konfigurierbaren Eigenschaft zu false. Im Beispiel kann die zweite Definition id nicht ändern, weil writable und configurable den Wert false haben; der Wert bleibt 7.

Beispiele

const item = {};

console.log(Reflect.defineProperty(item, "id", {
  value: 7,
  enumerable: true,
  writable: false,
  configurable: false
}));
console.log(Reflect.defineProperty(item, "id", { value: 8 }));
console.log(item.id);
console.log(Object.keys(item).join(","));

Ergebnis

true
false
7
id

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