Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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.

Zdroje