CKTIS / JavaScript
Object.isExtensible: se un oggetto accetta nuove proprietà
Object.isExtensible restituisce un booleano che indica se si possono ancora aggiungere nuove proprietà proprie a un oggetto.
Versione: ECMAScript 5 onward; primitives return false since ECMAScript 2015; example target: Node.js 24.22.2
Sintassi
Object.isExtensible(obj)Object.isExtensible(obj) invoca il metodo interno [[IsExtensible]] dell’oggetto e ne restituisce il booleano. Un nuovo oggetto ordinario è estensibile. Object.preventExtensions, Object.seal e Object.freeze impostano lo stato a false; per un oggetto ordinario non può poi essere ripristinato.
La non estensibilità impedisce nuove proprietà proprie, ma da sola non congela quelle esistenti. Una proprietà writable può ancora cambiare valore e una configurable può essere eliminata o riconfigurata secondo il descrittore. Quindi false non equivale né a Object.isSealed né a Object.isFrozen.
Il metodo esiste da ECMAScript 5; da ECMAScript 2015 ogni primitiva restituisce semplicemente false invece di generare eccezioni. Un Proxy può eseguire la trap isExtensible, il cui risultato è convertito a booleano. Deve coincidere con lo stato reale del target o viene generato TypeError; anche un’eccezione della trap si propaga.
Esempi
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); }Risultato
true false 2 false false TypeError
L’esempio confronta oggetti aperto e chiuso, cambia un valore, rifiuta una nuova proprietà e prova un invariante Proxy.