WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Proxy-Traps `get` und `set` und der Parameter `receiver`

Die Traps `get` und `set` fangen Eigenschaftszugriffe ab. Wer `receiver` an `Reflect` weitergibt, behält den Empfänger der ursprünglichen Operation bei.

Version: ECMAScript 2024 and the current web platform; runtime support varies

Syntax

const proxy = new Proxy(target, {
  get(target, key, receiver) {
    return Reflect.get(target, key, receiver);
  },
  set(target, key, value, receiver) {
    return Reflect.set(target, key, value, receiver);
  },
});

Bei new Proxy(target, handler) fängt get(target, key, receiver) die interne Operation [[Get]] ab und liefert den gelesenen Wert. set(target, key, value, receiver) fängt [[Set]] ab und meldet, ob das Schreiben erfolgreich war. key ist eine Zeichenkette oder ein Symbol. Fehlt der entsprechende Trap, leitet der Proxy die Operation mit demselben receiver an target weiter.

target ist das umhüllte Objekt. receiver wird dem Getter oder Setter als this übergeben. Beim gewöhnlichen direkten Zugriff ist das der Proxy; erreicht der Zugriff den Proxy über die Prototypenkette, kann es das vom Proxy erbende Objekt sein. Beim gewöhnlichen Schreiben einer Dateneigenschaft kann die Eigenschaft auf receiver angelegt oder aktualisiert werden.

Damit dieses Verhalten erhalten bleibt, gib Reflect.get(target, key, receiver) bzw. Reflect.set(target, key, value, receiver) aus den Traps zurück. Ohne das Argument receiver verwenden diese Aufrufe target als Empfänger. Auch direktes Lesen oder Zuweisen über target[key] verwendet target als Empfänger. Dieselbe Operation im Trap erneut am Proxy auszuführen, kann den Trap wieder aufrufen und zu Rekursion führen.

Der Rückgabewert des set-Traps wird in einen booleschen Wert umgewandelt. true meldet Erfolg, schreibt aber selbst nichts. Gibt [[Set]] den Wert false zurück, löst eine Zuweisung im Strict Mode einen TypeError aus; außerhalb des Strict Mode löst sie deshalb keinen Fehler aus. Reflect.set gibt in diesem Fall false zurück.

Die Engine erzwingt Regeln für eigene, nicht konfigurierbare Eigenschaften von target. Bei einer nicht schreibbaren Dateneigenschaft muss get denselben Wert gemäß Object.is liefern; set darf für einen anderen Wert keinen Erfolg melden. Bei einer Accessor-Eigenschaft ohne Getter muss get den Wert undefined liefern; ohne Setter darf set keinen Erfolg melden. Ein Verstoß löst unabhängig vom Strict Mode einen TypeError aus.

Beispiele

{
  const target = {
    points: 1,
    get score() { return this.points; },
    set score(value) { this.points = value; },
  };

  const proxy = new Proxy(target, {
    get(target, key, receiver) {
      return Reflect.get(target, key, receiver);
    },
    set(target, key, value, receiver) {
      return Reflect.set(target, key, value, receiver);
    },
  });

  const child = Object.create(proxy);
  console.log(`before: ${child.score}`);
  child.score = 7;
  console.log(`child: ${child.score}`);
  console.log(`target: ${target.score}`);
}

Ergebnis

before: 1
child: 7
target: 1

Im Getter und Setter von `score` ist `this` gleich `child`. Der erste Lesezugriff findet das geerbte `points`; der Setter legt `child.points` als eigene Eigenschaft an und lässt `target.points` unverändert.

Zugehörige Lektionen

  • JavaScript · Lektion 29 · Fortgeschritten · Version: 4

Quellen