CKTIS / JavaScript
Trampas `get` y `set` de `Proxy` y parámetro `receiver`
Las trampas `get` y `set` interceptan la lectura y la escritura de propiedades. Pasar `receiver` a `Reflect` conserva el receptor de la operación original.
Versión: ECMAScript 2024 and the current web platform; runtime support varies
Sintaxis
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);
},
});En new Proxy(target, handler), get(target, key, receiver) intercepta la operación interna [[Get]] y devuelve el valor leído. set(target, key, value, receiver) intercepta [[Set]] e indica si la escritura tuvo éxito. key es una cadena o un Symbol. Si falta la trampa correspondiente, el proxy reenvía la operación a target con el mismo receiver.
target es el objeto envuelto. receiver es el valor de this que recibe el getter o el setter. En un acceso directo ordinario es el proxy; si el acceso llega al proxy por la cadena de prototipos, puede ser el objeto que hereda del proxy. En una escritura ordinaria de una propiedad de datos, la propiedad puede crearse o actualizarse en receiver.
Para conservar ese comportamiento, devuelve Reflect.get(target, key, receiver) y Reflect.set(target, key, value, receiver) desde las trampas. Si se omite receiver, esas llamadas usan target como receptor. Leer o asignar directamente target[key] también usa target como receptor. Repetir la operación sobre el propio proxy dentro de la trampa puede volver a invocarla y causar recursión.
El valor devuelto por la trampa set se convierte en un booleano. true indica éxito, pero por sí solo no escribe nada. Si [[Set]] devuelve false, una asignación en modo estricto lanza TypeError, una asignación fuera de ese modo no lanza un error por ese motivo y Reflect.set devuelve false.
El motor impone reglas para las propiedades propias no configurables de target. Si una propiedad de datos no admite escritura, get debe devolver el mismo valor según Object.is, y set no puede indicar éxito para un valor distinto. Para una propiedad de acceso sin getter, get debe devolver undefined; si no hay setter, set no puede indicar éxito. Incumplir estas reglas provoca TypeError incluso fuera del modo estricto.
Ejemplos
{
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}`);
}Resultado
before: 1 child: 7 target: 1
En el getter y el setter de `score`, `this` es `child`. La primera lectura encuentra `points` por herencia; el setter crea la propiedad propia `child.points` y deja `target.points` sin cambios.
Lecciones relacionadas
- JavaScript · Lección 29 · Avanzado · Versión: 4