Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

Proxy — intercepter la lecture et l’écriture des propriétés

Proxy crée un objet qui sert d’intermédiaire pour les opérations sur un objet cible. Les méthodes handler.get et handler.set permettent de calculer des valeurs lors de la lecture et de contrôler les écritures, tout en respectant les invariants du langage.

Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntaxe

new Proxy(target, { get(target, property, receiver) { /* return value */ }, set(target, property, value, receiver) { /* return boolean */ } })

new Proxy(target, handler) crée un objet intermédiaire distinct ; il ne copie pas target. Les opérations effectuées directement sur target contournent les pièges. En l’absence d’un piège, l’opération correspondante est transmise à l’objet cible.

Proxy handler.get, sous la forme get(target, property, receiver), intercepte les lectures de propriétés et renvoie la valeur. property est une chaîne ou un symbole. receiver est le récepteur de l’opération, généralement le proxy ; le transmettre à Reflect.get(target, property, receiver) préserve le this approprié dans les accesseurs.

Proxy handler.set, sous la forme set(target, property, value, receiver), intercepte les écritures. Son résultat est converti en booléen : true signifie réussite et false refus. Une affectation refusée en mode strict déclenche une TypeError. Renvoyer true ne stocke pas à lui seul la valeur ; Reflect.set(target, property, value, receiver) effectue l’opération et en renvoie le résultat.

Les pièges doivent respecter les invariants : pour une propriété de données propre, non configurable et non modifiable, get ne peut pas renvoyer une valeur différente, et set ne peut pas signaler la réussite de l’écriture d’une valeur différente. Toute violation déclenche une TypeError. Dans l’exemple, double est calculé et l’écriture invalide de score est refusée.

Exemples

"use strict";
const target = { score: 0 };
const proxy = new Proxy(target, {
  get(target, property, receiver) {
    if (property === "double") return target.score * 2;
    return Reflect.get(target, property, receiver);
  },
  set(target, property, value, receiver) {
    if (property === "score" && !Number.isInteger(value)) return false;
    return Reflect.set(target, property, value, receiver);
  }
});

proxy.score = 7;
console.log(proxy.score);
console.log(proxy.double);
try {
  proxy.score = 1.5;
} catch (error) {
  console.log(error.name);
}
console.log(target.score);

Résultat

7
14
TypeError
7

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources