Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Trap `get` e `set` di `Proxy` e parametro `receiver`

Le trap `get` e `set` intercettano lettura e scrittura delle proprietà. Passare `receiver` a `Reflect` conserva il ricevente dell’operazione originale.

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

Sintassi

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), get(target, key, receiver) intercetta l’operazione interna [[Get]] e restituisce il valore letto. set(target, key, value, receiver) intercetta [[Set]] e indica se la scrittura è riuscita. key è una stringa o un Symbol. Se la trap corrispondente manca, il proxy inoltra l’operazione a target con lo stesso receiver.

target è l’oggetto avvolto dal proxy. receiver è il valore di this fornito al getter o al setter. In un accesso diretto ordinario è il proxy; se l’accesso raggiunge il proxy lungo la catena dei prototipi, può essere l’oggetto che eredita dal proxy. In una scrittura ordinaria di una proprietà dati, la proprietà può essere creata o aggiornata su receiver.

Per conservare questo comportamento, restituisci Reflect.get(target, key, receiver) e Reflect.set(target, key, value, receiver) dalle trap. Se ometti receiver, queste chiamate usano target come ricevente. Anche leggere o assegnare direttamente target[key] usa target come ricevente. Ripetere l’operazione sul proxy stesso dall’interno della trap può richiamare la trap e causare ricorsione.

Il valore restituito dalla trap set viene convertito in un booleano. true segnala il successo, ma da solo non scrive nulla. Se [[Set]] restituisce false, un’assegnazione in modalità strict genera un TypeError, un’assegnazione fuori da tale modalità non genera un errore per questo motivo e Reflect.set restituisce false.

Il motore impone regole per le proprietà proprie non configurabili di target. Per una proprietà dati non scrivibile, get deve restituire lo stesso valore secondo Object.is e set non può segnalare il successo per un valore diverso. Per una proprietà di accesso senza getter, get deve restituire undefined; senza setter, set non può segnalare il successo. Una violazione genera un TypeError anche fuori dalla modalità strict.

Esempi

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

Risultato

before: 1
child: 7
target: 1

Nel getter e nel setter di `score`, `this` è `child`. La prima lettura trova la proprietà ereditata `points`; il setter crea `child.points` come proprietà propria e lascia invariata `target.points`.

Lezioni correlate

  • JavaScript · Lezione 29 · Avanzato · Versione: 4

Fonti