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