Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Proxy — intercettare la lettura e la scrittura delle proprietà

Proxy crea un oggetto che fa da intermediario per le operazioni su un oggetto di destinazione. I metodi handler.get e handler.set consentono di calcolare i valori durante la lettura e controllare le scritture, rispettando gli invarianti del linguaggio.

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

Sintassi

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

new Proxy(target, handler) crea un oggetto intermediario separato; non copia target. Le operazioni eseguite direttamente su target aggirano le trap. Se una trap non è presente, l’operazione corrispondente viene inoltrata all’oggetto di destinazione.

Proxy handler.get, scritto come get(target, property, receiver), intercetta le letture delle proprietà e ne restituisce il valore. property è una stringa o un simbolo. receiver è il destinatario dell’operazione, di solito il proxy; passarlo a Reflect.get(target, property, receiver) conserva il this appropriato nei getter.

Proxy handler.set, scritto come set(target, property, value, receiver), intercetta le scritture. Il risultato viene convertito in un booleano: true indica successo e false rifiuto. Un’assegnazione rifiutata in modalità strict genera un TypeError. Restituire true da solo non memorizza il valore; Reflect.set(target, property, value, receiver) esegue l’operazione e ne restituisce il risultato.

Le trap devono rispettare gli invarianti: per una proprietà dati propria, non configurabile e non scrivibile, get non può restituire un valore diverso e set non può segnalare il successo della scrittura di un valore diverso. Le violazioni generano un TypeError. Nell’esempio, double viene calcolato e la scrittura non valida di score viene rifiutata.

Esempi

"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);

Risultato

7
14
TypeError
7

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti