CKTIS / JavaScript
Proxy: pułapki `get` i `set` oraz parametr `receiver`
Pułapki `get` i `set` przechwytują odczyt i zapis właściwości. Przekazanie `receiver` do metod `Reflect` zachowuje odbiorcę pierwotnej operacji.
Wersja: ECMAScript 2024 and the current web platform; runtime support varies
Składnia
const proxy = new Proxy(target, {
get(target, key, receiver) {
return Reflect.get(target, key, receiver);
},
set(target, key, value, receiver) {
return Reflect.set(target, key, value, receiver);
},
});W new Proxy(target, handler) pułapka get(target, key, receiver) przechwytuje wewnętrzną operację [[Get]] i zwraca wartość odczytu. Pułapka set(target, key, value, receiver) przechwytuje [[Set]] i informuje o powodzeniu zapisu. key to ciąg znaków lub Symbol. Jeśli brak odpowiedniej pułapki, proxy przekazuje operację do target z tym samym receiver.
target to obiekt opakowany przez proxy. Przy wywołaniu gettera lub settera receiver jest przekazywany jako argument this, ale nie musi być wartością this wewnątrz funkcji: funkcja związana przez bind może zignorować ten argument, a zwykła funkcja działająca poza trybem ścisłym może go przekształcić. Przy zwykłym dostępie bezpośrednim odbiorcą jest proxy, a przy dostępie przez łańcuch prototypów może to być obiekt dziedziczący po proxy. W przypadku zapisu zwykłej właściwości danych to właśnie na receiver właściwość może zostać utworzona lub zaktualizowana.
Aby zachować te zasady, zwracaj wyniki Reflect.get(target, key, receiver) i Reflect.set(target, key, value, receiver). Pominięcie receiver w tych wywołaniach oznacza użycie target jako odbiorcy. Bezpośredni odczyt lub przypisanie przez target[key] także zmienia odbiorcę na target. Wykonanie tej samej operacji na samym proxy wewnątrz pułapki może ponownie wywołać pułapkę i doprowadzić do rekurencji.
Wynik pułapki set jest konwertowany na wartość logiczną. true zgłasza powodzenie, ale samo nie zapisuje wartości. Jeśli [[Set]] zwróci false, przypisanie w trybie ścisłym zgłasza TypeError, poza tym trybem nie zgłasza błędu z tego powodu, a Reflect.set zwraca false.
Silnik egzekwuje ograniczenia dla własnych, niekonfigurowalnych właściwości target. Dla niezapisywalnej właściwości danych get musi zwrócić wartość zgodną z Object.is, a set nie może zgłosić powodzenia dla innej wartości. Dla właściwości akcesorowej bez gettera get musi zwrócić undefined; bez settera set nie może zgłosić powodzenia. Naruszenie tych reguł powoduje TypeError niezależnie od trybu ścisłego.
Przykłady
{
const target = {
points: 1,
get score() { return this.points; },
set score(value) { this.points = value; },
};
const proxy = new Proxy(target, {
get(target, key, receiver) {
return Reflect.get(target, key, receiver);
},
set(target, key, value, receiver) {
return Reflect.set(target, key, value, receiver);
},
});
const child = Object.create(proxy);
console.log(`before: ${child.score}`);
child.score = 7;
console.log(`child: ${child.score}`);
console.log(`target: ${target.score}`);
}Wynik
before: 1 child: 7 target: 1
W getterze i setterze `score` wartością `this` jest `child`. Początkowo `child` odczytuje odziedziczone `points`; zapis przez setter tworzy własne `child.points`, a `target.points` pozostaje bez zmian.
Powiązane lekcje
- JavaScript · Lekcja 29 · Zaawansowany · Wersja: 4