CKTIS / JavaScript
Object.assign: kopírování vlastních hodnot
Object.assign kopíruje hodnoty vyčíslitelných vlastních vlastností ze zdrojů do jednoho cílového objektu.
Verze: ECMAScript 2015 onward; example target: Node.js 24.22.2
Syntaxe
Object.assign(target, ...sources)Object.assign(target, ...sources) nejprve použije ToObject na target: null a undefined vyvolají TypeError, zatímco primitivní cíl se zabalí a vrátí jako objekt. Zdroje se zpracují zleva doprava; null a undefined se přeskočí, ostatní primitivní hodnoty se zabalí. Pozdější zdroj může přepsat dřívější hodnotu.
Pro každý zdroj algoritmus pořídí snímek OwnPropertyKeys. U každého klíče pak zkontroluje aktuální vlastní deskriptor a, je-li vyčíslitelný, provede Get ze zdroje a Set do cíle se zapnutým vyvoláním chyby. Kopíruje tedy vyčíslitelné vlastní řetězcové a symbolové klíče, nikoli zděděné či nevyčíslitelné vlastnosti. Gettery, settery a pasti Proxy se mohou spustit nebo vyvolat výjimku.
Jde o mělkou kopii hodnot: deskriptory, prototyp ani vnořené objekty se neklonují. Operace není transakční — pokud zápis do cíle jen pro čtení či nerozšiřitelného cíle nebo uživatelský kód vyvolá výjimku, dřívější zápisy zůstanou. Metoda existuje od ECMAScript 2015. U nedůvěryhodných zdrojů vybírej povolené klíče místo považování assign za bezpečné sloučení.
Příklady
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"));
}Výsledek
get score true first 7 ok false true stop true false
Příklad ukazuje pořadí zdrojů, getter, Symbol, vynechanou nevyčíslitelnou vlastnost, sdílenou referenci a částečný zápis po chybě.