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

CKTIS / JavaScript

Object.isSealed — comprobar si un objeto está sellado

Object.isSealed(value) comprueba si un objeto no es extensible y todas sus propiedades propias son no configurables. Esto no implica que los valores sean inmutables ni que los objetos anidados estén sellados.

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

Object.isSealed(value)

Object.isSealed(value) devuelve true cuando el objeto no es extensible y cada propiedad propia tiene configurable: false. La comprobación incluye las propiedades no enumerables y las claves Symbol, pero no las propiedades heredadas. Inspecciona el estado; a diferencia de Object.seal, no impone estas restricciones.

El sellado impide añadir y eliminar propiedades propias, así como los cambios prohibidos por su carácter no configurable. El sellado no cambia por sí mismo el atributo writable. En un objeto ordinario, se puede seguir asignando un valor nuevo a una propiedad de datos propia que sea escribible. En los objetos exóticos, en cambio, writable: true no garantiza que la asignación se realice correctamente. Por ejemplo, un objeto sellado de espacio de nombres de módulo indica writable: true para sus enlaces exportados, pero rechaza las asignaciones a esos enlaces. Object.isFrozen exige además que las propiedades de datos propias no sean escribibles. Ninguna de las dos comprobaciones es recursiva.

Object.preventExtensions por sí solo normalmente no basta si quedan propiedades configurables. Sin embargo, un objeto vacío no extensible sí está sellado. En ECMAScript actual, los argumentos primitivos, incluidos null y undefined, devuelven true; esto no significa que sean objetos.

Con un Proxy, la comprobación puede invocar trampas y lanzar una excepción, por lo que no siempre es una inspección sin efectos secundarios. Esta es una API del lenguaje ECMAScript, no una API web del navegador; la especificación del lenguaje no es una tabla de compatibilidad de navegadores.

Ejemplos

const item = { count: 1, nested: { active: true } };
console.log(Object.isSealed(item));
Object.seal(item);
item.count = 2;
console.log(Object.isSealed(item));
console.log(Object.isFrozen(item));
console.log(item.count);
console.log(Object.isSealed(item.nested));
console.log(Object.isSealed(Object.preventExtensions({})));
console.log(Object.isSealed(null));

Resultado

false
true
false
2
false
true
true

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