Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

Proxy – prestrezanje branja in zapisovanja lastnosti

Proxy ustvari objekt, ki posreduje pri operacijah na ciljnem objektu. Metodi handler.get in handler.set omogočata računanje vrednosti pri branju in nadzor zapisov ob upoštevanju jezikovnih invariant.

Različica: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaksa

new Proxy(target, { get(target, property, receiver) { /* return value */ }, set(target, property, value, receiver) { /* return boolean */ } })

new Proxy(target, handler) ustvari ločen posredniški objekt; target ne kopira. Operacije, izvedene neposredno na target, obidejo pasti. Če pasti ni, se ustrezna operacija posreduje ciljnemu objektu.

Proxy handler.get, zapisana kot get(target, property, receiver), prestreza branje lastnosti in vrne njeno vrednost. property je niz ali simbol. receiver je prejemnik operacije, običajno proxy; če ga posredujemo v Reflect.get(target, property, receiver), se v getterjih ohrani ustrezen this.

Proxy handler.set, zapisana kot set(target, property, value, receiver), prestreza zapise. Njen rezultat se pretvori v logično vrednost: true pomeni uspeh, false pa zavrnitev. Zavrnjena prireditev v strogem načinu sproži TypeError. Samo vračilo true vrednosti ne shrani; Reflect.set(target, property, value, receiver) izvede operacijo in vrne njen rezultat.

Pasti morajo upoštevati invariante: pri lastni, nekonfigurabilni in nezapisljivi podatkovni lastnosti get ne sme vrniti druge vrednosti, set pa ne sme sporočiti uspeha pri zapisovanju drugačne vrednosti. Kršitve sprožijo TypeError. V primeru se double izračuna, neveljaven zapis v score pa se zavrne.

Primeri

"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);

Rezultat

7
14
TypeError
7

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri