CKTIS / JavaScript
Proxy: interceptar lecturas y escrituras de propiedades
Proxy crea un objeto que media las operaciones sobre un objeto de destino. Los métodos handler.get y handler.set permiten calcular valores al leer y controlar las escrituras, respetando los invariantes del lenguaje.
Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxis
new Proxy(target, { get(target, property, receiver) { /* return value */ }, set(target, property, value, receiver) { /* return boolean */ } })new Proxy(target, handler) crea un objeto intermediario independiente; no copia target. Las operaciones realizadas directamente sobre target eluden las trampas. Si no hay una trampa, la operación correspondiente se reenvía al objeto de destino.
Proxy handler.get, escrito como get(target, property, receiver), intercepta las lecturas de propiedades y devuelve su valor. property es una cadena o un símbolo. receiver es el receptor de la operación, normalmente el proxy; pasarlo a Reflect.get(target, property, receiver) conserva el this adecuado en los getters.
Proxy handler.set, escrito como set(target, property, value, receiver), intercepta las escrituras. Su resultado se convierte en un booleano: true significa éxito y false, rechazo. Una asignación rechazada en modo estricto lanza un TypeError. Devolver true por sí solo no almacena el valor; Reflect.set(target, property, value, receiver) realiza la operación y devuelve su resultado.
Las trampas deben respetar los invariantes: para una propiedad de datos propia, no configurable y no escribible, get no puede devolver un valor distinto, y set no puede indicar que se ha escrito correctamente un valor diferente. Las infracciones lanzan un TypeError. En el ejemplo, double se calcula y se rechaza la escritura no válida de score.
Ejemplos
"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);Resultado
7 14 TypeError 7
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.