handler.defineProperty()

La méthode handler.defineProperty() est une trappe pour Object.defineProperty().

Le code source de cet exemple interactif est disponible dans un dépôt GitHub. Si vous souhaitez contribuez à ces exemples, n'hésitez pas à cloner https://github.com/mdn/interactive-examples et à envoyer une pull request !

var p = new Proxy(cible, {
  defineProperty: function(cible, propriété, descripteur) {
  }
});

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

cible

L'objet cible.

propriété

Le nom ou le symbole (Symbol) de la propriété dont on veut modifier la description.

descripteur

Le descripteur de la propriété qui est à modifier ou à définir.

La méthode defineProperty() doit renvoyer un booléen qui indique si la propriété a correctement été définie sur la cible.

La méthode handler.defineProperty() est une trappe pour Object.defineProperty().

Cette trappe intercepte les opérations suivantes :

• Object.defineProperty()
• Reflect.defineProperty()

Si les contraintes d'invariances suivantes ne sont pas respectées, le proxy renverra une exception TypeError :

• Une propriété ne peut pas être ajoutée si l'objet cible n'est pas extensible.
• Une propriété ne peut pas être ajoutée ou modifiée pour être rendue non-configurable si elle n'existe pas comme une propriété propre non-configurable de l'objet cible.
• Une propriété ne peut pas être non-configurable s'il existe une propriété correspondante de l'objet cible qui est configurable.
• Si une propriété correspondante existe pour l'objet cible Object.defineProperty(cible, propriété, descripteur) ne lèvera pas d'exception.
• En mode stricte, si le gestionnaire defineProperty renvoie une valeur fausse (dans un contexte booléen), cela entraînera une exception TypeError.

Dans le code suivant, on piège l'appel à Object.defineProperty().

var p = new Proxy({}, {
  defineProperty: function(target, prop, descriptor) {
    console.log("appelé avec : " + prop);
  }
});

var desc = { configurable: true, enumerable: true, value: 10 };
Object.defineProperty(p, "a", desc); // "appelé avec : a"

Lorsqu'on appelle Object.defineProperty() ou Reflect.defineProperty(), le descripteur passé à la trappe defineProperty doit respecter une contrainte : seules les propriétés suivants sont utilisables, les propriétés non-standards seront ignorées :

• enumerable
• configurable
• writable
• value
• get
• set

var p = new Proxy({}, {
  defineProperty(target, prop, descriptor) {
    console.log(descriptor);
    return Reflect.defineProperty(target, prop, descriptor);
  }
});

Object.defineProperty(p, "name, {
  value: "proxy",
  type: "custom"
});
// { value: "proxy" }

• Proxy
• handler
• Object.defineProperty()
• Reflect.defineProperty()