We're looking for a user researcher to understand the needs of developers and designers. Is this you or someone you know? Check out the post: https://mzl.la/2IGzdXS

Сводка

Метод Object.freeze() замораживает объект: это значит, что он предотвращает добавление новых свойств к объекту, удаление старых свойств из объекта и изменение существующих свойств или значения их атрибутов перечисляемости, настраиваемости и записываемости. В сущности, объект становится эффективно неизменным. Метод возвращает замороженный объект.

Синтаксис

Object.freeze(obj)

Параметры

obj
Объект для заморозки.

Возвращаемое значение

Замороженный объект

Описание

К замороженному объекту нельзя добавить никаких свойств, так же как и удалить свойства из замороженного объекта. Любые попытки сделать это потерпят неудачу, либо молча, либо выбросив исключение TypeError (как правило, но не обязательно, это происходит в строгом режиме).

Значения свойств-данных не могут быть изменены. Свойства-доступы (геттеры и сеттеры) работают как положено (и всё ещё создают иллюзию, что вы изменили значение). Обратите внимание, что значения, являющиеся объектами, всё ещё могут быть изменены, если только они так же не были заморожены.

Примеры

var obj = {
  prop: function() {},
  foo: 'bar'
};

// Можно добавлять новые свойства, существующие свойства можно изменять или удалять
obj.foo = 'baz';
obj.lumpy = 'woof';
delete obj.prop;

// Оба объекта эквивалентны, а также возвращаемый объект будет заморожен.
// Необязательно сохранять возвращаемый объект при заморозке оригинала.
var o = Object.freeze(obj);

o === obj; // true
Object.isFrozen(obj); // === true;

// Теперь все изменения будут заканчиваться с ошибкой
obj.foo = 'quux'; // тихо ничего не делает
obj.quaxxor = 'the friendly duck'; // тихо не добавляет свойство

// ...а в строгом режиме такие попытки вызовут выброс исключения TypeError
function fail() {
  'use strict';
  obj.foo = 'sparky'; // выбросит TypeError
  delete obj.quaxxor; // выбросит TypeError
  obj.sparky = 'arf'; // выбросит TypeError
}

fail();

// Попытки внести изменения через метод Object.defineProperty также выбросят исключение
Object.defineProperty(obj, 'ohai', { value: 17 }); // выбросит TypeError
Object.defineProperty(obj, 'foo', { value: 'eit' }); // выбросит TypeError

Следующий пример показывает, что значения-объекты в замороженном объекте могут быть изменены (заморозка неглубокая).

obj = {
  internal: {}
};

Object.freeze(obj);
obj.internal.a = 'значениеA';

obj.internal.a // 'значениеA'

// Чтобы сделать объект obj полностью неизменяемым, замораживаем каждый объект в объекте obj.
// Для этого воспользуемся этой функцией.
function deepFreeze(obj) {

  // Получаем имена свойств из объекта obj
  var propNames = Object.getOwnPropertyNames(obj);

  // Замораживаем свойства для заморозки самого объекта
  propNames.forEach(function(name) {
    var prop = obj[name];

    // Заморозка свойства prop, если оно объект
    if (typeof prop == 'object' && prop !== null)
      deepFreeze(prop);
  });

  // Заморозить сам объект obj (ничего не произойдёт, если он уже заморожен)
  return Object.freeze(obj);
}

obj2 = {
  internal: {}
};

deepFreeze(obj2);
obj2.internal.a = 'другоеЗначение';
obj2.internal.a; // undefined

Примечания

В ES5 если аргумент метода не является объектом (является примитивным значением), будет выброшено исключение TypeError. В ES2015 такой аргумент будет рассматриваться, как простой замороженный объект и метод его просто вернёт.

> Object.freeze(1)
TypeError: 1 is not an object // код ES5

> Object.freeze(1)
1                             // код ES2015

Спецификации

Спецификация Статус Комментарии
ECMAScript 5.1 (ECMA-262)
Определение 'Object.freeze' в этой спецификации.
Стандарт Изначальное определение. Реализована в JavaScript 1.8.5.
ECMAScript 2015 (6th Edition, ECMA-262)
Определение 'Object.freeze' в этой спецификации.
Стандарт  
ECMAScript Latest Draft (ECMA-262)
Определение 'Object.freeze' в этой спецификации.
Черновик  

Совместимость с браузерами

We're converting our compatibility data into a machine-readable JSON format. This compatibility table still uses the old format, because we haven't yet converted the data it contains. Find out how you can help!

Возможность Firefox (Gecko) Chrome Internet Explorer Opera Safari
Базовая поддержка 4.0 (2) 6 9 12 5.1
Возможность Firefox Mobile (Gecko) Android IE Mobile Opera Mobile Safari Mobile
Базовая поддержка ? ? ? ? ?

На основе таблицы совместимости Kangax.

Смотрите также

Метки документа и участники

Внесли вклад в эту страницу: WispProxy, kdex, pk.prog, chayn1k, Mingun
Обновлялась последний раз: WispProxy,