CKTIS / JavaScript
Object.isExtensible : possibilité d’ajouter des propriétés
Object.isExtensible renvoie un booléen indiquant si de nouvelles propriétés propres peuvent encore être ajoutées à un objet.
Version : ECMAScript 5 onward; primitives return false since ECMAScript 2015; example target: Node.js 24.22.2
Syntaxe
Object.isExtensible(obj)Object.isExtensible(obj) appelle la méthode interne [[IsExtensible]] de l’objet et renvoie son booléen. Un objet ordinaire neuf est extensible. Object.preventExtensions, Object.seal et Object.freeze passent cet état à false ; pour un objet ordinaire, il ne peut ensuite être rétabli.
La non-extensibilité bloque les nouvelles propriétés propres, sans figer à elle seule les existantes. Une propriété inscriptible peut encore changer de valeur et une configurable peut être supprimée ou reconfigurée selon son descripteur. Un résultat false n’équivaut donc ni à Object.isSealed ni à Object.isFrozen.
La méthode existe depuis ECMAScript 5 ; depuis ECMAScript 2015 toute primitive renvoie simplement false au lieu de lever. Un Proxy peut exécuter son piège isExtensible, dont le résultat est converti en booléen. Il doit correspondre à l’état réel de la cible, sinon TypeError est levé ; une exception du piège se propage aussi.
Exemples
const open = { value: 1 };
const closed = Object.preventExtensions({ value: 1 });
console.log(Object.isExtensible(open), Object.isExtensible(closed));
closed.value = 2;
console.log(closed.value, Reflect.defineProperty(closed, "extra", { value: 3 }));
console.log(Object.isExtensible(7));
const proxy = new Proxy(closed, { isExtensible() { return true; } });
try { Object.isExtensible(proxy); } catch (error) { console.log(error.name); }Résultat
true false 2 false false TypeError
L’exemple compare objets ouvert et fermé, modifie une valeur existante, refuse une nouvelle propriété et teste un invariant Proxy.