KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

Proxy-traps `get` en `set` en de parameter `receiver`

De traps `get` en `set` onderscheppen het lezen en schrijven van eigenschappen. Door `receiver` aan `Reflect` door te geven, blijft de oorspronkelijke ontvanger behouden.

Versie: 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);
  },
});

In new Proxy(target, handler) onderschept get(target, key, receiver) de interne operatie [[Get]] en geeft het de gelezen waarde terug. set(target, key, value, receiver) onderschept [[Set]] en meldt of de schrijfactie is gelukt. key is een tekenreeks of een Symbol. Ontbreekt de betreffende trap, dan stuurt de proxy de operatie met dezelfde receiver door naar target.

target is het object dat door de proxy wordt omhuld. receiver wordt als this aan de getter of setter doorgegeven. Bij gewone rechtstreekse toegang is dat de proxy; als de toegang via de prototypeketen bij de proxy uitkomt, kan het het object zijn dat van de proxy erft. Bij een gewone schrijfactie naar een data-eigenschap kan de eigenschap op receiver worden aangemaakt of bijgewerkt.

Behoud dit gedrag door Reflect.get(target, key, receiver) en Reflect.set(target, key, value, receiver) vanuit de traps terug te geven. Laat je receiver weg, dan gebruiken deze aanroepen target als ontvanger. Ook rechtstreeks lezen of toewijzen via target[key] gebruikt target als ontvanger. Voer je dezelfde operatie binnen de trap op de proxy zelf uit, dan kan de trap opnieuw worden aangeroepen en kan recursie ontstaan.

De retourwaarde van de set-trap wordt omgezet naar een booleaanse waarde. true meldt succes, maar schrijft op zichzelf niets. Als [[Set]] false teruggeeft, veroorzaakt een toewijzing in strict mode een TypeError. Buiten strict mode veroorzaakt de toewijzing om die reden geen fout, en Reflect.set geeft false terug.

De engine handhaaft regels voor eigen, niet-configureerbare eigenschappen van target. Voor een niet-schrijfbare data-eigenschap moet get dezelfde waarde teruggeven volgens Object.is, en mag set geen succes melden voor een andere waarde. Voor een accessor-eigenschap zonder getter moet get undefined teruggeven; zonder setter mag set geen succes melden. Een overtreding veroorzaakt een TypeError, ook buiten strict mode.

Voorbeelden

{
  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}`);
}

Resultaat

before: 1
child: 7
target: 1

In de getter en setter van `score` is `this` gelijk aan `child`. De eerste leesactie vindt de geërfde eigenschap `points`; de setter maakt `child.points` aan als eigen eigenschap en laat `target.points` ongewijzigd.

Gerelateerde lessen

  • JavaScript · Les 29 · Gevorderd · Versie: 4

Bronnen