KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

Proxy — het lezen en schrijven van eigenschappen onderscheppen

Proxy maakt een object dat bewerkingen op een doelobject bemiddelt. Met de methoden handler.get en handler.set kun je waarden berekenen bij het lezen en schrijfbewerkingen controleren, met behoud van de invarianten van de taal.

Versie: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

new Proxy(target, { get(target, property, receiver) { /* return value */ }, set(target, property, value, receiver) { /* return boolean */ } })

new Proxy(target, handler) maakt een afzonderlijk bemiddelend object; het kopieert target niet. Bewerkingen die rechtstreeks op target worden uitgevoerd, omzeilen de traps. Als een trap ontbreekt, wordt de bijbehorende bewerking doorgestuurd naar het doelobject.

Proxy handler.get, geschreven als get(target, property, receiver), onderschept het lezen van eigenschappen en geeft de waarde terug. property is een tekenreeks of symbool. receiver is de ontvanger van de bewerking, meestal de proxy; door deze door te geven aan Reflect.get(target, property, receiver) blijft de juiste this in getters behouden.

Proxy handler.set, geschreven als set(target, property, value, receiver), onderschept schrijfbewerkingen. Het resultaat wordt omgezet naar een boolean: true betekent succes en false betekent afwijzing. Een afgewezen toewijzing veroorzaakt in strict mode een TypeError. Alleen true teruggeven slaat de waarde niet op; Reflect.set(target, property, value, receiver) voert de bewerking uit en geeft het resultaat terug.

Traps moeten invarianten respecteren: bij een eigen, niet-configureerbare en niet-beschrijfbare data-eigenschap mag get geen andere waarde teruggeven en mag set niet melden dat het schrijven van een andere waarde is gelukt. Schendingen veroorzaken een TypeError. In het voorbeeld wordt double berekend en wordt de ongeldige toewijzing aan score afgewezen.

Voorbeelden

"use strict";
const target = { score: 0 };
const proxy = new Proxy(target, {
  get(target, property, receiver) {
    if (property === "double") return target.score * 2;
    return Reflect.get(target, property, receiver);
  },
  set(target, property, value, receiver) {
    if (property === "score" && !Number.isInteger(value)) return false;
    return Reflect.set(target, property, value, receiver);
  }
});

proxy.score = 7;
console.log(proxy.score);
console.log(proxy.double);
try {
  proxy.score = 1.5;
} catch (error) {
  console.log(error.name);
}
console.log(target.score);

Resultaat

7
14
TypeError
7

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen