CKTIS / JavaScript
Proxy – zachytávanie čítania a zápisu vlastností
Proxy vytvára objekt, ktorý sprostredkúva operácie s cieľovým objektom. Metódy handler.get a handler.set umožňujú pri čítaní počítať hodnoty a riadiť zápisy pri dodržaní invariantov jazyka.
Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
new Proxy(target, { get(target, property, receiver) { /* return value */ }, set(target, property, value, receiver) { /* return boolean */ } })new Proxy(target, handler) vytvorí samostatný sprostredkujúci objekt; target nekopíruje. Operácie vykonané priamo na target obchádzajú pasce. Ak pasca chýba, príslušná operácia sa odovzdá cieľovému objektu.
Proxy handler.get, zapísaná ako get(target, property, receiver), zachytáva čítanie vlastností a vracia ich hodnotu. property je reťazec alebo symbol. receiver je prijímateľ operácie, zvyčajne proxy; jeho odovzdaním do Reflect.get(target, property, receiver) sa zachová správne this v gettrech.
Proxy handler.set, zapísaná ako set(target, property, value, receiver), zachytáva zápisy. Jej výsledok sa prevedie na logickú hodnotu: true znamená úspech a false odmietnutie. Odmietnuté priradenie v prísnom režime vyvolá TypeError. Samotné vrátenie true hodnotu neuloží; Reflect.set(target, property, value, receiver) vykoná operáciu a vráti jej výsledok.
Pasce musia dodržiavať invarianty: pri vlastnej, nekonfigurovateľnej a nezapisovateľnej dátovej vlastnosti nesmie get vrátiť inú hodnotu a set nesmie oznámiť úspešný zápis inej hodnoty. Porušenie vyvolá TypeError. V príklade sa double vypočíta a neplatný zápis do score sa odmietne.
Príklady
"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);Výsledok
7 14 TypeError 7
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.