handler.getOwnPropertyDescriptor()

Les paramètres suivants sont passés à la méthode getOwnPropertyDescriptor. this est ici lié au gestionnaire (handler).

cible

L'objet cible

prop

Le nom de la propriété dont on souhaite obtenir le descripteur.

La méthode getOwnPropertyDescriptor doit renvoyer un objet ou undefined.

La méthode handler.getOwnPropertyDescriptor() est une trappe pour un proxy afin d'intercepter les opérations effectuées avec Object.getOwnPropertyDescriptor().

Cette trappe permet d'intercepter :

• Object.getOwnPropertyDescriptor()
• Reflect.getOwnPropertyDescriptor()

Si les invariants suivants ne sont pas respectés, le proxy lèvera une exception TypeError :

• getOwnPropertyDescriptor doit renvoyer un objet ou undefined.
• Une propriété ne peut pas être indiquée comme non-existante s'il existe une propriété correspondante de l'objet cible qui est une propriété propre et non-configurable.
• Une propriété ne peut pas être indiquée comme non-existante s'il existe une propriété correspondante de l'objet cible qui est une propriété propre et que l'objet cible n'est pas extensible.
• Une propriété ne peut pas être indiquée comme existante si elle n'existe pas de façon correspondante sur l'objet cible et que l'objet cible n'est pas extensible.
• Une propriété ne peut pas être indiquée comme non-configurable si la propriété correspondante n'existe pas pour l'objet cible ou si elle existe comme un propriété propre configurable.
• Le résultat de Object.getOwnPropertyDescriptor(cible) peut être appliqué à l'objet cible avec Object.defineProperty sans que cela lève une exception.

Dans l'exemple qui suit, on intercepte Object.getOwnPropertyDescriptor().

var p = new Proxy({ a: 20 }, {
  getOwnPropertyDescriptor: function(cible, prop) {
    console.log("appelée : " + prop);
    return { configurable: true, enumerable: true, value: 10 };
  }
});

console.log(Object.getOwnPropertyDescriptor(p, "a").value); // "appelée : a"
                                                            // 10

L'exemple suivant ne respecte pas un invariant :

var obj = { a: 10 };
Object.preventExtensions(obj);
var p = new Proxy(obj, {
  getOwnPropertyDescriptor: function(cible, prop) {
    return undefined;
  }
});

Object.getOwnPropertyDescriptor(p, "a"); // Une exception TypeError est renvoyée

• Proxy
• handler (en-US)
• Object.getOwnPropertyDescriptor()
• Reflect.getOwnPropertyDescriptor()