Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

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.

Sources