Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / JavaScript

Object.isExtensible: si un objeto acepta propiedades nuevas

Object.isExtensible devuelve un booleano que indica si aún se pueden añadir propiedades propias nuevas a un objeto.

Versión: ECMAScript 5 onward; primitives return false since ECMAScript 2015; example target: Node.js 24.22.2

Sintaxis

Object.isExtensible(obj)

Object.isExtensible(obj) invoca el método interno [[IsExtensible]] del objeto y devuelve su booleano. Un objeto ordinario nuevo es extensible. Object.preventExtensions, Object.seal y Object.freeze cambian ese estado a false; en un objeto ordinario no puede restaurarse después.

La no extensibilidad bloquea propiedades propias nuevas, pero por sí sola no congela las existentes. Una propiedad escribible aún puede cambiar de valor y una configurable puede eliminarse o reconfigurarse dentro de sus reglas. Por ello un resultado false no equivale a Object.isSealed ni a Object.isFrozen.

Existe desde ECMAScript 5; desde ECMAScript 2015 cualquier primitiva devuelve simplemente false en vez de lanzar. Un Proxy puede ejecutar su trampa isExtensible, cuyo resultado se convierte a booleano. Debe coincidir con la extensibilidad real del destino o se lanza TypeError; una excepción de la trampa también se propaga.

Ejemplos

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

El ejemplo compara objetos abierto y cerrado, cambia un valor existente, rechaza una propiedad nueva y prueba un invariante Proxy.

Fuentes