Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

Proxy — presretanje čitanja i pisanja svojstava

Proxy stvara objekt koji posreduje pri operacijama nad ciljnim objektom. Metode handler.get i handler.set omogućuju izračunavanje vrijednosti pri čitanju i kontrolu upisa uz poštovanje jezičnih invarijanti.

Verzija: 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) stvara zaseban posrednički objekt; ne kopira target. Operacije koje se izravno izvršavaju nad target zaobilaze zamke. Ako zamka ne postoji, odgovarajuća se operacija prosljeđuje ciljnom objektu.

Proxy handler.get, zapisan kao get(target, property, receiver), presreće čitanje svojstava i vraća njihovu vrijednost. property je niz znakova ili simbol. receiver je primatelj operacije, obično proxy; prosljeđivanjem u Reflect.get(target, property, receiver) čuva se odgovarajući this u getterima.

Proxy handler.set, zapisan kao set(target, property, value, receiver), presreće upise. Rezultat se pretvara u logičku vrijednost: true znači uspjeh, a false odbijanje. Odbijena dodjela u strogom načinu rada baca TypeError. Samo vraćanje vrijednosti true ne pohranjuje vrijednost; Reflect.set(target, property, value, receiver) izvršava operaciju i vraća njezin rezultat.

Zamke moraju poštovati invarijante: za vlastito, nekonfigurabilno i nezapisivo podatkovno svojstvo get ne smije vratiti drukčiju vrijednost, a set ne smije prijaviti uspjeh pri upisu drukčije vrijednosti. Kršenja uzrokuju TypeError. U primjeru se double izračunava, a neispravan upis u score odbija.

Primjeri

"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

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori