Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje