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

CKTIS / JavaScript

Reflect.isExtensible — comprobar la extensibilidad de un objeto

Reflect.isExtensible(target) comprueba si un objeto es extensible. En un objeto ordinario, la extensibilidad significa que se le pueden añadir nuevas propiedades propias. El método devuelve un booleano y lanza TypeError para los valores primitivos.

Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaxis

Reflect.isExtensible(target)

Reflect.isExtensible(target) devuelve true si un objeto es extensible y false si no lo es. En un objeto ordinario, la extensibilidad significa que se le pueden añadir nuevas propiedades propias. El método consulta este estado, pero no lo modifica por sí mismo.

Object.preventExtensions(target) impide añadir nuevas propiedades propias. Object.seal(target) y Object.freeze(target) también hacen que los objetos no sean extensibles, pero imponen restricciones adicionales. Por tanto, false no significa que el objeto esté congelado: las propiedades existentes que sean de escritura pueden seguir modificándose, y las propiedades configurables pueden seguir eliminándose. Un objeto ordinario no puede volver a hacerse extensible.

El argumento debe ser un objeto; los arrays y las funciones también son objetos. Los valores primitivos, incluidos null y undefined, provocan un TypeError. Esta es una diferencia importante respecto a Object.isExtensible(target), que devuelve false para los primitivos en lugar de lanzar una excepción.

El método invoca la operación interna [[IsExtensible]]. En un Proxy, puede invocar la trampa isExtensible, así que no des por sentado que carece de efectos secundarios. Tras convertirlo a booleano, el resultado de la trampa debe coincidir con la extensibilidad real del objeto objetivo; de lo contrario, se produce un TypeError. Un proxy revocado también provoca un TypeError.

Ejemplos

const item = { count: 1 };
console.log(Reflect.isExtensible(item));

Object.preventExtensions(item);
console.log(Reflect.isExtensible(item));
console.log(Reflect.set(item, "extra", 10));

item.count = 2;
console.log(item.count);

try {
  Reflect.isExtensible(42);
} catch (error) {
  console.log(error.name);
}

Resultado

true
false
false
2
TypeError

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes