handler.set()

Die folgenden Parameter werden an die Methode set() übergeben. this ist an den Handler gebunden.

target

Das Zielobjekt.

property

Ein String oder ein Symbol, das den Eigenschaftsnamen darstellt.

value

Der neue Wert der Eigenschaft, der festgelegt werden soll.

receiver

Der this-Wert für Setter; siehe Reflect.set(). Dies ist normalerweise entweder der Proxy selbst oder ein Objekt, das vom Proxy erbt.

Die Methode set() muss ein Boolean zurückgeben, das angibt, ob die Zuweisung erfolgreich war oder nicht. Andere Werte werden in Booleans umgewandelt.

Viele Operationen, einschließlich der Verwendung von Eigenschaftszuweisern im Strict-Modus, werfen einen TypeError, wenn die [[Set]] interne Methode false zurückgibt.

Diese Trap kann folgende Operationen abfangen:

• Eigenschaftszuweisung: proxy[foo] = bar und proxy.foo = bar
• Reflect.set()

Oder jede andere Operation, die die [[Set]] interne Methode aufruft.

Die [[Set]] interne Methode des Proxys wirft einen TypeError, wenn die Handler-Definition eine der folgenden Invarianten verletzt:

• Der Wert einer Eigenschaft kann nicht von dem Wert der entsprechenden Zielobjekteigenschaft abweichen, wenn die entsprechende Zielobjekteigenschaft eine nicht beschreibbare, nicht konfigurierbare eigene Dieneigenschaft ist. Das heißt, wenn Reflect.getOwnPropertyDescriptor() für die Eigenschaft auf target configurable: false, writable: false zurückgibt und value sich vom value-Attribut im Eigenschaftsdescriptor von target unterscheidet, muss die Trap einen falschen Wert zurückgeben.
• Der Wert einer Eigenschaft kann nicht gesetzt werden, wenn die entsprechende Zielobjekteigenschaft eine nicht konfigurierbare eigene Accessor-Eigenschaft ist, die einen undefinierten Setter hat. Das heißt, wenn Reflect.getOwnPropertyDescriptor() für die Eigenschaft auf target configurable: false, set: undefined zurückgibt, muss die Trap einen falschen Wert zurückgeben.

Der folgende Code fängt das Setzen eines Eigenschaftswerts ab.

const p = new Proxy(
  {},
  {
    set(target, prop, value, receiver) {
      target[prop] = value;
      console.log(`property set: ${prop} = ${value}`);
      return true;
    },
  },
);

console.log("a" in p); // false

p.a = 10; // "property set: a = 10"
console.log("a" in p); // true
console.log(p.a); // 10

• Proxy
• Proxy() Konstruktor
• Reflect.set()