re:re:actable
Урок 112 минуты чтения

Object.assign()

На этой странице
Кратко

Object.assign(target, ...sources) копирует собственные перечисляемые свойства из источников в target, мутирует target и возвращает его.

Вопрос

Что делает Object.assign()?

Синтаксис

Object.assign(target, source1, source2);

Пример:

const target = { a: 1 };
const source = { b: 2 };
 
const result = Object.assign(target, source);
 
console.log(target); // { a: 1, b: 2 }
console.log(result === target); // true

Объединение объектов

const defaults = { theme: "light", pageSize: 20 };
const userSettings = { pageSize: 50 };
 
const settings = Object.assign({}, defaults, userSettings);
 
console.log(settings); // { theme: "light", pageSize: 50 }

Если ключи совпадают, правый источник перезаписывает левый.

Поверхностная копия

const user = {
  name: "Anna",
  address: { city: "Moscow" },
};
 
const copy = Object.assign({}, user);
 
copy.address.city = "Kazan";
 
console.log(user.address.city); // "Kazan"

Вложенные объекты копируются по ссылке.

Что копируется

Копируются:

  • собственные свойства;
  • enumerable-свойства;
  • строковые и symbol-ключи.

Не копируются:

  • свойства из прототипа;
  • неперечисляемые свойства.

null и undefined

null и undefined нельзя использовать как target.

Object.assign(null, {}); // TypeError

Как sources они игнорируются:

Object.assign({}, null, undefined, { a: 1 }); // { a: 1 }

Что важно помнить

  • Object.assign(target, ...sources) мутирует и возвращает target.
  • Копирует только собственные перечисляемые свойства и вызывает сеттеры целевого объекта.
  • Копия поверхностная, как и spread.
  • Опасно сливать в объект данные пользователя без фильтрации — риск prototype pollution через ключ __proto__ в глубоком merge.

Мини-шпаргалка

КодЧто делает
Object.assign(target, source)мутирует target
Object.assign({}, obj)shallow copy
Object.assign({}, a, b)merge
{ ...obj }часто более короткая альтернатива

Документация

MDN: Object.assign().

Дочитали до конца?
Отметьте урок — прогресс сохранится в браузере.

Поиск

Поиск по урокам