CKTIS / JavaScript
Proxy — прихващане на четене и запис на свойства
Proxy създава обект, който посредничи при операциите върху целеви обект. Методите handler.get и handler.set позволяват изчисляване на стойности при четене и контрол на записите при спазване на инвариантите на езика.
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
new Proxy(target, { get(target, property, receiver) { /* return value */ }, set(target, property, value, receiver) { /* return boolean */ } })new Proxy(target, handler) създава отделен посреднически обект; не копира target. Операциите, извършени директно върху target, заобикалят капаните. Ако даден капан липсва, съответната операция се препраща към целевия обект.
Proxy handler.get, записан като get(target, property, receiver), прихваща четенето на свойства и връща стойността. property е низ или символ. receiver е получателят на операцията, обикновено proxy; подаването му към Reflect.get(target, property, receiver) запазва подходящия this в getter-ите.
Proxy handler.set, записан като set(target, property, value, receiver), прихваща записите. Резултатът се преобразува в булева стойност: true означава успех, а false — отказ. Отхвърлено присвояване в строг режим хвърля TypeError. Самото връщане на true не записва стойността; Reflect.set(target, property, value, receiver) извършва операцията и връща резултата ѝ.
Капаните трябва да спазват инвариантите: за собствено, неконфигурируемо и незаписваемо свойство за данни get не може да върне различна стойност, а set не може да отчете успех при запис на различна стойност. Нарушенията хвърлят TypeError. В примера double се изчислява, а невалидният запис в score се отхвърля.
Примери
"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);Резултат
7 14 TypeError 7
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.