WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Reflect.set — Eigenschaftszuweisung mit booleschem Ergebnis

Reflect.set führt eine Eigenschaftszuweisung aus und gibt als booleschen Wert an, ob sie erfolgreich war. Mit dem optionalen receiver lassen sich das Objekt, bei dem die Eigenschaftssuche beginnt, und das Objekt, in das geschrieben wird, voneinander unterscheiden.

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.set(target, key, value[, receiver])

Reflect.set(target, key, value[, receiver]) ruft die interne [[Set]]-Operation des Objekts target auf. Das Argument key wird in einen Eigenschaftsschlüssel umgewandelt: einen String oder ein Symbol. Wird receiver weggelassen, ist der Standardwert target.

Das Ergebnis ist true oder false, nicht der zugewiesene Wert. Bei gewöhnlichen Objekten kann false beispielsweise bedeuten, dass versucht wurde, eine Eigenschaft mit writable: false zu ändern, einen Accessor ohne Setter zu verwenden oder eine Eigenschaft zu einem nicht erweiterbaren Empfänger hinzuzufügen. Allein ein Ergebnis von false löst auch im Strict-Modus keinen Fehler aus – anders als eine abgewiesene Zuweisung mit target[key] = value in diesem Modus.

Die Suche nach einem Deskriptor beginnt bei target und kann dessen Prototypen durchlaufen. Bei einer beschreibbaren Dateneigenschaft wird durch den Schreibvorgang im Allgemeinen eine eigene Eigenschaft auf receiver erstellt oder aktualisiert, vorbehaltlich dessen Einschränkungen. Beim Aufruf eines Setters wird receiver als this-Argument übergeben. Ist der Setter eine gewöhnliche JavaScript-Funktion außerhalb des Strict-Modus, wird für null oder undefined der globale this-Wert verwendet; andere primitive Werte werden in Wrapper-Objekte umgewandelt. Der Rückgabewert des Setters wird ignoriert. Daher garantiert true nicht, dass ein späterer Lesezugriff value zurückgibt.

Die Methode fängt keine Fehler ab: Ein nicht als Objekt verwendbares target verursacht einen TypeError, und Ausnahmen bei der Schlüsselumwandlung, aus einem Setter oder aus einer Proxy-Falle werden weitergegeben. Beim direkten Definieren einer eigenen Eigenschaft wird weder die Prototypenkette durchsucht noch ein geerbter Setter aufgerufen. Die Einschränkungen des Deskriptors einer bestehenden eigenen Eigenschaft gelten aber weiterhin. So lässt sich etwa der Wert einer eigenen Dateneigenschaft, die weder konfigurierbar noch beschreibbar ist, nicht ändern.

Beispiele

"use strict";
const target = { score: 1 };
const receiver = {};
console.log(Reflect.set(target, "score", 7, receiver));
console.log(target.score, receiver.score);

Object.defineProperty(target, "fixed", {
  value: 10,
  writable: false
});
console.log(Reflect.set(target, "fixed", 20));
console.log(target.fixed);

Ergebnis

true
1 7
false
10

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