handler.preventExtensions()
Baseline
Widely available
Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis septembre 2016.
La méthode handler.preventExtensions() est une trappe pour Object.preventExtensions().
Exemple interactif
const monster1 = {
canEvolve: true,
};
const handler1 = {
preventExtensions(target) {
target.canEvolve = false;
Object.preventExtensions(target);
return true;
},
};
const proxy1 = new Proxy(monster1, handler1);
console.log(monster1.canEvolve);
// Expected output: true
Object.preventExtensions(proxy1);
console.log(monster1.canEvolve);
// Expected output: false
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 renvoietrueque siObject.isExtensible(proxy)vautfalse.
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
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-proxy-object-internal-methods-and-internal-slots-preventextensions |
Compatibilité des navigateurs
Chargement…