handler.preventExtensions()

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

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 !

Syntaxe

var p = new Proxy(cible, {
  preventExtensions: function(cible) {
  }
});

Paramètres

Le paramètre suivant est passé à la méthode preventExtensions. this est lié au gestionnaire (handler).

cible

L'objet cible.

Valeur de retour

La méthode preventExtensions doit renvoyer une valeur booléenne.

Description

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

Interceptions

Cette trappe peut intercepter les opérations de :

• Object.preventExtensions()
• Reflect.preventExtensions()

Invariants

Si les invariants suivants ne sont pas respectés, le proxy renverra une execption TypeError :

• Object.preventExtensions(proxy) ne renvoie true que si Object.isExtensible(proxy) vaut false.

Exemples

On intercepte l'appel à Object.preventExtensions() dans l'exemple suivant :

var p = new Proxy({}, {
  preventExtensions: function(cible) {
    console.log("appelé");
    Object.preventExtensions(cible);
    return true;
  }
});

console.log(Object.preventExtensions(p)); // "appelé"
                                          // true

Le code suivant ne respecte pas l'invariant :

var p = new Proxy({}, {
  preventExtensions: function(cible) {
    return true;
  }
});

Object.preventExtensions(p); // TypeError est levée

Spécifications

Compatibilité des navigateurs

Voir aussi

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