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.