Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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

Źródła