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

CKTIS / JavaScript

Object.isFrozen — comprobar si un objeto está congelado

Object.isFrozen(value) comprueba si un objeto no es extensible, sus propiedades propias no son configurables y sus propiedades de datos tampoco son modificables. No congela el objeto ni comprueba recursivamente los objetos anidados.

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.isFrozen(value)

Object.isFrozen(value) es un método estático que devuelve true cuando no se pueden añadir propiedades propias a un objeto, todas sus propiedades propias tienen configurable: false y sus propiedades propias de datos también tienen writable: false. Se incluyen las claves de símbolo y las propiedades no enumerables, pero no las heredadas.

El método inspecciona el estado en lugar de cambiarlo; usa Object.freeze para congelar un objeto. Object.seal por sí solo no basta si quedan propiedades de datos modificables. Sin embargo, un objeto vacío queda congelado después de Object.preventExtensions, porque no tiene propiedades que incumplan las demás condiciones.

Un resultado true no implica inmutabilidad profunda. Los objetos guardados como valores de propiedades aún pueden cambiar. Las propiedades de acceso pueden conservar setters, y los getters pueden devolver resultados variables; la comprobación no exige eliminarlos ni invoca los getters de un objeto ordinario.

Para los valores primitivos, incluidos null y undefined, la especificación actual devuelve true. Con un Proxy, la inspección puede activar trampas y lanzar una excepción, así que no siempre es una operación sin efectos secundarios.

Ejemplos

const settings = { theme: { dark: false } };
console.log(Object.isFrozen(settings));
Object.freeze(settings);
console.log(Object.isFrozen(settings));
console.log(Object.isFrozen(settings.theme));
settings.theme.dark = true;
console.log(settings.theme.dark);
console.log(Object.isFrozen(Object.preventExtensions({})));
console.log(Object.isFrozen(null));

Resultado

false
true
false
true
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