Урок 132 минуты чтения
Object.freeze, Object.seal и Object.preventExtensions
На этой странице
Кратко
Три уровня защиты объекта. Object.preventExtensions(obj) запрещает добавлять новые свойства. Object.seal(obj) дополнительно запрещает удалять свойства и менять их флаги, но значения менять можно. Object.freeze(obj) запрещает всё: добавлять, удалять и изменять. Все три — поверхностные: вложенные объекты остаются изменяемыми.
Вопрос
Что делают Object.freeze(), Object.seal() и Object.preventExtensions()? Чем они отличаются и как сделать глубокую заморозку?
Сравнение
| Операция | preventExtensions | seal | freeze |
|---|---|---|---|
| Добавить свойство | ❌ | ❌ | ❌ |
| Удалить свойство | ✅ | ❌ | ❌ |
| Изменить значение | ✅ | ✅ | ❌ |
| Изменить флаги | ✅ | ❌ | ❌ |
| Проверка | Object.isExtensible | Object.isSealed | Object.isFrozen |
Примеры
"use strict";
const settings = Object.preventExtensions({ theme: "light" });
settings.theme = "dark"; // OK
delete settings.theme; // OK
settings.lang = "ru"; // TypeError
const user = Object.seal({ name: "Анна" });
user.name = "Мария"; // OK
delete user.name; // TypeError
user.age = 25; // TypeError
const config = Object.freeze({ apiUrl: "/api", retries: 3 });
config.retries = 5; // TypeErrorБез strict mode нарушения молча игнорируются, что усложняет поиск ошибок. Модули и классы всегда работают в strict mode.
Заморозка поверхностная
const state = Object.freeze({ user: { name: "Анна" }, tags: ["a"] });
state.user.name = "Мария"; // работает!
state.tags.push("b"); // работает!Глубокая заморозка:
function deepFreeze(obj) {
for (const value of Object.values(obj)) {
if (value !== null && typeof value === "object" && !Object.isFrozen(value)) {
deepFreeze(value);
}
}
return Object.freeze(obj);
}Где применяется
- константы и конфигурация, которые не должны меняться;
- защита от случайной мутации state в dev-режиме (Immer и Redux Toolkit замораживают результат);
- перечисления до появления
enumв TypeScript:
const Status = Object.freeze({
Pending: "pending",
Done: "done",
});- массивы:
Object.freeze([1, 2])запрещаетpush,sortи присваивание по индексу.
Что важно помнить
freezeнеобратим: «разморозить» объект нельзя, можно только создать копию.constиfreezeрешают разные задачи:constзапрещает переназначить переменную,freeze— менять объект.- Прототип нерасширяемого объекта (после любого из трех методов) сменить нельзя:
Object.setPrototypeOfброситTypeError. MapиSetне замораживаются по содержимому:Object.freeze(new Map()).set(1, 1)работает — данные хранятся во внутренних слотах.- В TypeScript
Readonly<T>иas constдают похожую защиту на этапе компиляции без runtime-затрат.
Мини-шпаргалка
preventExtensions— нельзя добавлять.seal— нельзя добавлять и удалять.freeze— нельзя ничего.- Все три поверхностные — для вложенных нужен
deepFreeze. - Без strict mode ошибки молчат.
Документация
MDN: Object.freeze(), MDN: Object.seal(), MDN: Object.preventExtensions().
Дочитали до конца?
Отметьте урок — прогресс сохранится в браузере.