CKTIS / JavaScript
Object.freeze: nível superior sem extensão nem escrita
Object.freeze impede a extensão e reconfiguração das propriedades próprias e torna não graváveis as propriedades de dados próprias.
Versão: ECMAScript 5 onward; primitive-return behavior since ECMAScript 2015; example target: Node.js 24.22.2
Sintaxe
Object.freeze(value)Object.freeze(value) devolve uma primitiva sem alterações. Para um objeto executa SetIntegrityLevel no nível frozen: impede novas propriedades, define configurable: false em todas as propriedades próprias e também writable: false nas propriedades de dados próprias. Devolve o mesmo objeto.
Uma propriedade accessor mantém getter e setter; perde apenas a configurabilidade. O congelamento é superficial: objetos aninhados, elementos privados e dados internos de Map e Set não se tornam automaticamente imutáveis. Um setter ainda pode alterar estado aninhado ou externo. Imutabilidade profunda requer uma travessia controlada e segura perante ciclos do grafo de dados.
O método existe desde ECMAScript 5; devolver não objetos em vez de lançar aplica-se desde ECMAScript 2015. A falha de PreventExtensions ou violação de invariantes por Proxy lança TypeError. Typed arrays com elementos não podem ser congeladas e também lançam TypeError; uma typed array de comprimento zero pode ser congelada.
Exemplos
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
O exemplo confirma atributos de dados e accessor, congelamento superficial, uma primitiva e o erro de typed array.