Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes