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.