Objetivo, handler y trampas
new Proxy(objetivo, handler) recibe el objeto que envuelve y un handler, un objeto con las trampas: una función por cada operación que quieras interceptar. Las que no defines, pasan directo al objetivo.
| Trampa | Intercepta |
|---|---|
get(obj, prop, receptor) |
Leer: p.x, p[x] |
set(obj, prop, valor, receptor) |
Escribir: p.x = 1 |
has(obj, prop) |
"x" in p |
deleteProperty(obj, prop) |
delete p.x |
ownKeys(obj) |
Object.keys(p), for...in |
apply(fn, this, args) |
Llamar: p(1, 2) (si el objetivo es una función) |
construct(Clase, args) |
new p() |
Hay algunas más, una por cada operación interna del lenguaje.
Reflect: la operación normal
Reflect tiene un método por cada trampa, con los mismos argumentos, que hace lo que el lenguaje haría sin proxy. Así, la trampa agrega su comportamiento y delega el resto:
const registro = [];
const espiado = new Proxy({ a: 1 }, {
get(obj, prop, receptor) {
registro.push(`leyó ${String(prop)}`);
return Reflect.get(obj, prop, receptor);
},
set(obj, prop, valor, receptor) {
registro.push(`escribió ${String(prop)} = ${valor}`);
return Reflect.set(obj, prop, valor, receptor);
},
});
espiado.a;
espiado.b = 2;
console.log(registro);
Usa Reflect en lugar de obj[prop]: respeta los getters, los prototipos y los descriptores, y en set devuelve el booleano que la trampa tiene que devolver.
Usos reales
Validación:
function validado(objetivo, reglas) {
return new Proxy(objetivo, {
set(obj, prop, valor) {
const regla = reglas[prop];
if (regla && !regla(valor)) throw new TypeError(`Valor inválido para ${String(prop)}: ${valor}`);
return Reflect.set(obj, prop, valor);
},
});
}
const usuario = validado({}, { edad: (v) => Number.isInteger(v) && v >= 0 });
usuario.edad = 31;
try {
usuario.edad = -5;
} catch (e) {
console.log(e.message);
}
Reactividad: avisar cada vez que algo cambia, que es como Vue actualiza la página.
function reactivo(objetivo, alCambiar) {
return new Proxy(objetivo, {
set(obj, prop, valor) {
const antes = obj[prop];
const ok = Reflect.set(obj, prop, valor);
if (antes !== valor) alCambiar(prop, antes, valor);
return ok;
},
});
}
const estado = reactivo({ contador: 0 }, (prop, antes, ahora) => console.log(`${prop}: ${antes} → ${ahora}`));
estado.contador++;
estado.contador++;
Interceptar funciones con apply:
const medido = new Proxy(Math.max, {
apply(fn, thisArg, args) {
console.log(`max llamado con ${args.length} argumentos`);
return Reflect.apply(fn, thisArg, args);
},
});
console.log(medido(3, 9, 4));
Límites
- Invariantes: un proxy no puede mentir sobre ciertas cosas del objetivo. Si una propiedad no es configurable ni
writable, la trampagettiene que devolver su valor real, o se lanza unTypeError. - Identidad: el proxy y el objetivo son objetos distintos (
proxy !== objetivo). - Campos privados y objetos nativos: los
#camposde una clase y los datos internos deMap,DateoSetno se ven a través del proxy. Llamarproxy.get()sobre unMapenvuelto falla, porquethises el proxy y no elMap. - Rendimiento: cada operación pasa por una función. En código que se ejecuta millones de veces, se nota.
Resumen
- Un Proxy envuelve un objeto y sus trampas interceptan operaciones:
get,set,has,deleteProperty,apply,construct… - Reflect hace la operación normal: úsalo dentro de las trampas para delegar.
- La trampa
setdebe devolvertruesi la asignación funcionó. - Usos: validación, valores por defecto, registro, reactividad, índices negativos.
- Límites: invariantes, identidad distinta, campos privados y nativos, rendimiento.
¡A practicar!
Tu progreso se guarda en este navegador.
Autoevaluación: Interceptar operaciones
Resuelto
Elige una respuesta en cada pregunta.
¿Qué es un
Proxy?¿Qué trampa se ejecuta en
proxy.nombre?¿Para qué sirve
Reflect?¿Qué debe devolver la trampa
set?
Ordena la salida: Índices negativos
Resuelto
Un array envuelto que entiende índices negativos. Ordena lo que aparecería en la consola.
1const lista = new Proxy(["a", "b", "c"], {2 get(arr, prop, receptor) {3 const i = Number(prop);4 if (Number.isInteger(i) && i < 0) return arr[arr.length + i];5 return Reflect.get(arr, prop, receptor);6 },7});8 9console.log(lista[-1]);10console.log(lista[0], lista.length);11console.log(Array.isArray(lista));12console.log("b" in lista, 5 in lista);Consola, de arriba abajo
- true
- c
- false false
- a 3
La trampa get recibe la propiedad como texto ("-1"), la convierte y calcula desde el final. Lo demás lo hace Reflect.get como siempre. Array.isArray ve a través del proxy. in usa otra trampa, has, que no definimos: pregunta por índices y "b" es un valor, no un índice.
Detective: Una trampa set que no avisa
Resuelto
La validación debería rechazar solo las edades negativas, pero rechaza todo. Encuentra la línea y elige el arreglo.
Consola
persona.js:9
persona.nombre = "Ana";
^
TypeError: 'set' on proxy: trap returned falsish for property 'nombre'Paso 1: toca la línea de código que causa el error.
Paso 2: ¿cómo lo arreglas?
Laboratorio: Valores por defecto
Resuelto
Escribe conDefecto(obj, defecto) con un Proxy y Reflect.
$ node programa.js
Lo que debe cumplir
- Imprime
helloy¿?(pendiente) - Respeta los valores que existen aunque sean falsy (pendiente)
- Usa
new ProxyyReflect(pendiente)
Una solución
1function conDefecto(obj, defecto) {2 return new Proxy(obj, {3 get(o, prop) {4 return Reflect.has(o, prop) ? Reflect.get(o, prop) : defecto;5 },6 });7}8 9const traducciones = conDefecto({ hola: "hello", adios: "bye" }, "¿?");10console.log(traducciones.hola);11console.log(traducciones.gracias);Con ?? defecto también funcionaría para undefined, pero Reflect.has pregunta si la propiedad existe, que es lo que querías. Un detalle: como has mira también el prototipo, traducciones.toString devuelve la función heredada, no el valor por defecto.