Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Proxy — przechwytywanie odczytu i zapisu właściwości

Proxy tworzy obiekt pośredniczący w operacjach na obiekcie docelowym. Metody handler.get i handler.set pozwalają obliczać wartości przy odczycie oraz kontrolować zapis, z zachowaniem niezmienników języka.

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

Składnia

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

new Proxy(target, handler) tworzy osobny obiekt pośredniczący; nie kopiuje target. Operacje wykonane bezpośrednio na target omijają pułapki. Brak pułapki oznacza przekazanie odpowiedniej operacji do obiektu docelowego.

Proxy handler.get, czyli get(target, property, receiver), przechwytuje odczyt właściwości i zwraca jej wartość. property jest napisem lub symbolem. receiver to odbiorca operacji, zwykle proxy; przekazanie go do Reflect.get(target, property, receiver) zachowuje właściwe this w getterach.

Proxy handler.set, czyli set(target, property, value, receiver), przechwytuje zapis. Wynik jest konwertowany na wartość logiczną: true oznacza sukces, a false odrzucenie. Odrzucone przypisanie w trybie ścisłym zgłasza TypeError. Samo zwrócenie true nie zapisuje wartości; Reflect.set(target, property, value, receiver) wykonuje operację i zwraca jej wynik.

Pułapki muszą przestrzegać niezmienników: dla własnej, niekonfigurowalnej i niezapisywalnej właściwości danych get nie może zwrócić innej wartości, a set nie może zgłosić sukcesu zapisu innej wartości. Naruszenie powoduje TypeError. W przykładzie double jest wartością obliczaną, a niepoprawny zapis score zostaje odrzucony.

Przykłady

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

Wynik

7
14
TypeError
7

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła