CKTIS / JavaScript
Reflect.isExtensible — vérifier l’extensibilité d’un objet
Reflect.isExtensible(target) vérifie si un objet est extensible. Pour un objet ordinaire, cela signifie qu’on peut lui ajouter de nouvelles propriétés propres. La méthode renvoie un booléen et déclenche une TypeError pour les valeurs primitives.
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.isExtensible(target)Reflect.isExtensible(target) renvoie true si un objet est extensible, et false dans le cas contraire. Pour un objet ordinaire, l’extensibilité signifie que de nouvelles propriétés propres peuvent être ajoutées. La méthode lit cet état, mais ne le modifie pas elle-même.
Object.preventExtensions(target) empêche l’ajout de nouvelles propriétés propres. Object.seal(target) et Object.freeze(target) rendent également les objets non extensibles, mais imposent des restrictions supplémentaires. Ainsi, false ne signifie pas que l’objet est gelé : les propriétés existantes modifiables peuvent toujours être changées, et les propriétés configurables peuvent toujours être supprimées. Un objet ordinaire ne peut pas redevenir extensible.
L’argument doit être un objet ; les tableaux et les fonctions sont aussi des objets. Les valeurs primitives, notamment null et undefined, provoquent une TypeError. C’est une différence importante avec Object.isExtensible(target), qui renvoie false pour les primitives au lieu de déclencher une erreur.
La méthode appelle l’opération interne [[IsExtensible]]. Pour un Proxy, elle peut déclencher le piège isExtensible : ne partez donc pas du principe que l’appel est sans effets secondaires. Après conversion en booléen, le résultat du piège doit correspondre à l’extensibilité réelle de l’objet cible ; sinon, une TypeError se produit. Un proxy révoqué provoque également une TypeError.
Exemples
const item = { count: 1 };
console.log(Reflect.isExtensible(item));
Object.preventExtensions(item);
console.log(Reflect.isExtensible(item));
console.log(Reflect.set(item, "extra", 10));
item.count = 2;
console.log(item.count);
try {
Reflect.isExtensible(42);
} catch (error) {
console.log(error.name);
}Résultat
true false false 2 TypeError
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.