База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

Object.assign: копиране на собствени стойности

Object.assign копира стойности на изброими собствени свойства от източници в един целеви обект.

Версия: ECMAScript 2015 onward; example target: Node.js 24.22.2

Синтаксис

Object.assign(target, ...sources)

Object.assign(target, ...sources) първо прилага ToObject към target: null и undefined хвърлят TypeError, а примитивна цел се опакова и връща като обект. Източниците се обработват отляво надясно; null и undefined се пропускат, а другите примитиви се опаковат. По-късен източник може да презапише по-ранна стойност.

За всеки източник алгоритъмът взема snapshot на OwnPropertyKeys. После за всеки ключ проверява текущия собствен descriptor и, ако е enumerable, изпълнява Get върху източника и Set върху целта с включено хвърляне на грешка. Така се копират enumerable собствени string и symbol ключове, но не наследени или non-enumerable свойства. Getters, setters и Proxy traps могат да се изпълнят или да хвърлят.

Това е плитко копиране на стойности: descriptors, prototype и вложените обекти не се клонират. Операцията не е транзакционна — ако запис в read-only или non-extensible цел или потребителски код хвърли, по-ранните записи остават. Методът съществува от ECMAScript 2015. При ненадеждни източници избирай позволени ключове, вместо да приемаш assign за безопасно сливане.

Примери

const token = Symbol("token");
const nested = { enabled: true };
const source = { get score() { console.log("get score"); return 7; }, nested };
Object.defineProperty(source, "hidden", { value: 9, enumerable: false });
source[token] = "ok";
const target = { score: 1, label: "base" };
const result = Object.assign(target, { label: "first" }, source);
console.log(result === target, result.label, result.score, result[token], Object.hasOwn(result, "hidden"));
console.log(result.nested === nested);
const partial = {};
const failing = {};
Object.defineProperties(failing, {
  b: { enumerable: true, get() { throw new Error("stop"); } },
  c: { enumerable: true, value: 3 }
});
try { Object.assign(partial, { a: 1 }, failing); } catch (error) {
  console.log(error.message, Object.hasOwn(partial, "a"), Object.hasOwn(partial, "c"));
}

Резултат

get score
true first 7 ok false
true
stop true false

Примерът показва ред на източниците, getter, Symbol, пропуснато non-enumerable свойство, споделена референция и частичен запис след грешка.

Източници