CKTIS / JavaScript
Reflect.preventExtensions — empêcher l’extension d’un objet
Reflect.preventExtensions(target) empêche l’ajout de nouvelles propriétés propres à un objet et renvoie un booléen. La méthode ne rend pas immuables les propriétés existantes et peut toujours lever des exceptions.
Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
Reflect.preventExtensions(target)Reflect.preventExtensions(target) appelle l’opération interne [[PreventExtensions]] de l’objet. Elle renvoie true si l’opération réussit, ou false si elle est refusée. L’argument doit être un objet ; une valeur primitive, y compris null, provoque une TypeError. Les exceptions de l’opération interne sont propagées : un résultat booléen ne signifie pas qu’aucune exception ne peut survenir.
Pour un objet ordinaire, la réussite empêche définitivement l’ajout de nouvelles propriétés propres, y compris celles dont la clé est un symbole. Un nouvel appel renvoie true. Il n’est pas non plus possible de remplacer le prototype par un autre. Les propriétés existantes peuvent toujours être modifiées ou supprimées si leurs descripteurs le permettent ; les objets imbriqués ne sont pas modifiés.
Cette méthode n’équivaut pas à Object.seal ni à Object.freeze : elle ne modifie pas les attributs configurable ou writable. Object.preventExtensions renvoie son argument en cas de réussite et lève une TypeError lorsque l’opération renvoie false ; elle renvoie les valeurs primitives sans les modifier. Reflect.preventExtensions expose plutôt le résultat booléen et rejette les valeurs primitives.
Un Proxy peut intercepter l’opération avec son piège preventExtensions. Ce piège peut la refuser en renvoyant false, mais annoncer une réussite alors que la cible reste extensible provoque une TypeError. Dans l’exemple, Reflect.set illustre l’échec de l’ajout d’une propriété sans dépendre du mode strict.
Exemples
const item = { count: 1 };
console.log(Reflect.preventExtensions(item));
console.log(Reflect.isExtensible(item));
console.log(Reflect.set(item, "extra", 10));
item.count = 2;
console.log(item.count);
console.log(Reflect.deleteProperty(item, "count"));
console.log(Reflect.has(item, "count"));Résultat
true false false 2 true false
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.