Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes