CKTIS / JavaScript
Proxy – zachycení čtení a zápisu vlastností
Proxy vytváří objekt, který zprostředkovává operace s cílovým objektem. Metody handler.get a handler.set umožňují při čtení počítat hodnoty a řídit zápisy při dodržení invariantů jazyka.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
new Proxy(target, { get(target, property, receiver) { /* return value */ }, set(target, property, value, receiver) { /* return boolean */ } })new Proxy(target, handler) vytvoří samostatný zprostředkující objekt; target nekopíruje. Operace provedené přímo na target obcházejí pasti. Pokud past chybí, odpovídající operace se předá cílovému objektu.
Proxy handler.get, zapsaná jako get(target, property, receiver), zachytává čtení vlastností a vrací jejich hodnotu. property je řetězec nebo symbol. receiver je příjemce operace, obvykle proxy; jeho předáním do Reflect.get(target, property, receiver) se zachová správné this v gettrech.
Proxy handler.set, zapsaná jako set(target, property, value, receiver), zachytává zápisy. Její výsledek se převede na logickou hodnotu: true znamená úspěch a false odmítnutí. Odmítnuté přiřazení v přísném režimu vyvolá TypeError. Samotné vrácení true hodnotu neuloží; Reflect.set(target, property, value, receiver) operaci provede a vrátí její výsledek.
Pasti musí dodržovat invarianty: u vlastní, nekonfigurovatelné a nezapisovatelné datové vlastnosti nesmí get vrátit jinou hodnotu a set nesmí oznámit úspěch zápisu jiné hodnoty. Porušení vyvolá TypeError. V příkladu se double vypočítá a neplatný zápis do score se odmítne.
Pří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ýsledek
7 14 TypeError 7
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.