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 свойство, споделена референция и частичен запис след грешка.