handler.preventExtensions()

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

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 :

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

Spécification Statut Commentaires
ECMAScript 2015 (6th Edition, ECMA-262)
La définition de '[[PreventExtensions]]' dans cette spécification.
Standard Définition initiale.
ECMAScript 2016 Draft (7th Edition, ECMA-262)
La définition de '[[PreventExtensions]]' dans cette spécification.
Projet  

Compatibilité des navigateurs

Fonctionnalité Chrome Firefox (Gecko) Internet Explorer Opera Safari
Support simple ? 22 (22) ? ? ?
Fonctionnalité Android Chrome pour Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Support simple ? ? 22.0 (22) ? ? ?

Voir aussi

Étiquettes et contributeurs liés au document

 Contributeurs à cette page : SphinxKnight
 Dernière mise à jour par : SphinxKnight,