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

CKTIS / JavaScript

Object.freeze: nivel superior sin extensión ni escritura

Object.freeze impide extender y reconfigurar las propiedades propias y vuelve no escribibles las propiedades de datos propias.

Versión: ECMAScript 5 onward; primitive-return behavior since ECMAScript 2015; example target: Node.js 24.22.2

Sintaxis

Object.freeze(value)

Object.freeze(value) devuelve una primitiva sin cambios. Para un objeto ejecuta SetIntegrityLevel con nivel frozen: impide propiedades nuevas, establece configurable: false en todas las propiedades propias y también writable: false en las propiedades de datos propias. Devuelve el mismo objeto.

Una propiedad de acceso conserva getter y setter; solo pierde la capacidad de configurarse. La congelación es superficial: objetos anidados, elementos privados y datos internos de Map y Set no se vuelven inmutables automáticamente. Un setter aún puede cambiar estado anidado o externo. La inmutabilidad profunda requiere recorrer el grafo de forma controlada y segura ante ciclos.

El método existe desde ECMAScript 5; devolver valores que no son objetos en vez de lanzar rige desde ECMAScript 2015. El fallo de PreventExtensions o la violación de invariantes por un Proxy lanza TypeError. Las typed arrays con elementos no se pueden congelar y también lanzan TypeError; una typed array de longitud cero sí puede congelarse.

Ejemplos

const config = {
  nested: { enabled: false },
  get status() { return this.nested.enabled; },
  set status(value) { this.nested.enabled = value; }
};
const same = Object.freeze(config);
const nested = Object.getOwnPropertyDescriptor(config, "nested");
const status = Object.getOwnPropertyDescriptor(config, "status");
console.log(same === config, Object.isFrozen(config));
console.log(nested.writable, nested.configurable, typeof status.set, status.configurable);
config.status = true;
console.log(config.nested.enabled, config.status);
console.log(Object.freeze(7));
try { Object.freeze(new Uint8Array([1])); }
catch (error) { console.log(error.name); }

Resultado

true true
false false function false
true true
7
TypeError

El ejemplo confirma atributos de datos y acceso, congelación superficial, una primitiva y el error de typed array.

Fuentes