CKTIS / JavaScript
Pièges `get` et `set` de `Proxy` et paramètre `receiver`
Les pièges `get` et `set` interceptent la lecture et l’écriture des propriétés. Transmettre `receiver` à `Reflect` préserve le receveur de l’opération initiale.
Version : ECMAScript 2024 and the current web platform; runtime support varies
Syntaxe
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);
},
});Dans new Proxy(target, handler), get(target, key, receiver) intercepte l’opération interne [[Get]] et renvoie la valeur lue. set(target, key, value, receiver) intercepte [[Set]] et indique si l’écriture a réussi. key est une chaîne ou un Symbol. En l’absence du piège correspondant, le proxy transmet l’opération à target avec le même receiver.
target est l’objet enveloppé par le proxy. receiver est la valeur de this fournie au getter ou au setter. Lors d’un accès direct ordinaire, c’est le proxy ; si l’accès atteint le proxy via la chaîne de prototypes, ce peut être l’objet qui en hérite. Lors d’une écriture ordinaire sur une propriété de données, celle-ci peut être créée ou mise à jour sur receiver.
Pour conserver ce comportement, renvoyez Reflect.get(target, key, receiver) et Reflect.set(target, key, value, receiver) depuis les pièges. Si l’argument receiver est omis, ces appels prennent target comme receveur. Lire ou affecter directement target[key] utilise également target comme receveur. Répéter l’opération sur le proxy lui-même depuis le piège peut rappeler le piège et provoquer une récursion.
La valeur renvoyée par le piège set est convertie en booléen. true signale un succès mais n’écrit rien à lui seul. Si [[Set]] renvoie false, une affectation en mode strict lève une TypeError, une affectation hors mode strict ne lève pas d’erreur pour cette raison, et Reflect.set renvoie false.
Le moteur impose des règles pour les propriétés propres non configurables de target. Pour une propriété de données non modifiable, get doit renvoyer la même valeur au sens de Object.is, et set ne peut pas signaler un succès pour une valeur différente. Pour une propriété d’accès sans getter, get doit renvoyer undefined ; sans setter, set ne peut pas signaler un succès. Toute violation déclenche une TypeError, même hors mode strict.
Exemples
{
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}`);
}Résultat
before: 1 child: 7 target: 1
Dans le getter et le setter de `score`, `this` vaut `child`. La première lecture trouve la propriété `points` héritée ; le setter crée `child.points` comme propriété propre, sans modifier `target.points`.
Leçons associées
- JavaScript · Leçon 29 · Avancé · Version : 4