CKTIS / JavaScript
Object.freeze: najwyższy poziom bez rozszerzania i zapisu
Object.freeze blokuje rozszerzanie obiektu oraz rekonfigurację jego własnych właściwości, a własne właściwości danych czyni niezapisywalnymi.
Wersja: ECMAScript 5 onward; primitive-return behavior since ECMAScript 2015; example target: Node.js 24.22.2
Składnia
Object.freeze(value)Object.freeze(value) zwraca wartość pierwotną bez zmian. Dla obiektu wykonuje SetIntegrityLevel z poziomem frozen: zapobiega dodawaniu właściwości, ustawia configurable: false na wszystkich własnych właściwościach, a na właściwościach danych także writable: false. Zwraca ten sam obiekt.
Właściwość akcesora zachowuje getter i setter; jedynie staje się niekonfigurowalna. Zamrożenie jest płytkie: zagnieżdżone obiekty, elementy prywatne oraz wewnętrzne dane Map i Set nie stają się automatycznie niezmienne. Setter może nadal zmieniać zagnieżdżony lub zewnętrzny stan. Do głębokiej niezmienności potrzebne jest kontrolowane, cykloodporne przejście po grafie danych.
Metoda istnieje od ECMAScript 5; zwracanie nieobiektowych wartości zamiast błędu obowiązuje od ECMAScript 2015. Niepowodzenie PreventExtensions albo naruszenie niezmienników przez Proxy powoduje TypeError. Typowanych tablic z elementami nie można zamrozić i również rzucają TypeError, natomiast typowana tablica o zerowej długości może zostać zamrożona.
Przykłady
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); }Wynik
true true false false function false true true 7 TypeError
Przykład potwierdza atrybuty danych i akcesora, płytkość zamrożenia, obsługę liczby i błąd typowanej tablicy.