База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

Капаните `get` и `set` на `Proxy` и параметърът `receiver`

Капаните `get` и `set` прихващат четене и запис на свойства. Подаването на `receiver` към `Reflect` запазва получателя на първоначалната операция.

Версия: ECMAScript 2024 and the current web platform; runtime support varies

Синтаксис

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);
  },
});

В new Proxy(target, handler) капанът get(target, key, receiver) прихваща вътрешната операция [[Get]] и връща прочетената стойност. set(target, key, value, receiver) прихваща [[Set]] и съобщава дали записът е успешен. key е низ или Symbol. Ако съответният капан липсва, проксито препраща операцията към target със същия receiver.

target е обектът, обвит от проксито. receiver е стойността на this, която получава гетърът или сетърът. При обикновен пряк достъп това е проксито; ако достъпът стигне до него по прототипната верига, това може да е обектът, който наследява от проксито. При обикновен запис на свойство за данни свойството може да се създаде или обнови върху receiver.

За да запазиш това поведение, върни Reflect.get(target, key, receiver) и Reflect.set(target, key, value, receiver) от капаните. Ако пропуснеш аргумента receiver, тези извиквания ще използват target като получател. Прякото четене или присвояване чрез target[key] също използва target като получател. Повтарянето на операцията върху самото прокси в капана може да извика капана отново и да доведе до рекурсия.

Върнатата от капана set стойност се преобразува в булева стойност. true съобщава за успех, но само по себе си не записва нищо. Ако [[Set]] върне false, присвояването в строг режим хвърля TypeError, извън строг режим не хвърля грешка по тази причина, а Reflect.set връща false.

Двигателят налага правила за собствените неконфигурируеми свойства на target. За свойство за данни, което не допуска запис, get трябва да върне същата стойност според Object.is, а set не може да съобщи успех за различна стойност. За аксесорно свойство без гетър get трябва да върне undefined; без сетър set не може да съобщи успех. Нарушаването на тези правила хвърля TypeError независимо от строгия режим.

Примери

{
  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}`);
}

Резултат

before: 1
child: 7
target: 1

В гетъра и сетъра на `score` стойността на `this` е `child`. Първото четене намира наследеното свойство `points`; сетърът създава собственото свойство `child.points` и оставя `target.points` непроменено.

Свързани уроци

  • JavaScript · Урок 29 · Напреднало · Версия: 4

Източници