CKTIS / JavaScript
Object.isExtensible: se um objeto aceita novas propriedades
Object.isExtensible devolve um booleano que indica se ainda podem ser adicionadas novas propriedades próprias a um objeto.
Versão: ECMAScript 5 onward; primitives return false since ECMAScript 2015; example target: Node.js 24.22.2
Sintaxe
Object.isExtensible(obj)Object.isExtensible(obj) invoca o método interno [[IsExtensible]] do objeto e devolve o seu booleano. Um objeto normal novo é extensível. Object.preventExtensions, Object.seal e Object.freeze mudam esse estado para false; num objeto normal não pode depois ser restaurado.
A não extensibilidade bloqueia novas propriedades próprias, mas só por si não congela as existentes. Uma propriedade writable ainda pode mudar de valor e uma configurable pode ser apagada ou reconfigurada segundo o descritor. Assim, false não equivale a Object.isSealed nem a Object.isFrozen.
O método existe desde ECMAScript 5; desde ECMAScript 2015 qualquer primitiva devolve simplesmente false em vez de lançar. Um Proxy pode executar a trap isExtensible, cujo resultado é convertido a booleano. Tem de coincidir com a extensibilidade real do alvo ou é lançado TypeError; uma exceção da trap também se propaga.
Exemplos
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); }Resultado
true false 2 false false TypeError
O exemplo compara objetos aberto e fechado, muda um valor, rejeita uma nova propriedade e testa um invariante Proxy.