CKTIS / JavaScript
Object.assign: kopírovanie vlastných hodnôt
Object.assign kopíruje hodnoty vyčísliteľných vlastných vlastností zo zdrojov do jedného cieľového objektu.
Verzia: ECMAScript 2015 onward; example target: Node.js 24.22.2
Syntax
Object.assign(target, ...sources)Object.assign(target, ...sources) najprv použije ToObject na target: null a undefined vyvolajú TypeError, kým primitívny cieľ sa zabalí a vráti ako objekt. Zdroje sa spracujú zľava doprava; null a undefined sa preskočia, ostatné primitívne hodnoty sa zabalia. Neskorší zdroj môže prepísať skoršiu hodnotu.
Pre každý zdroj algoritmus vytvorí snímku OwnPropertyKeys. Pri každom kľúči potom skontroluje aktuálny vlastný deskriptor a, ak je vyčísliteľný, vykoná Get zo zdroja a Set do cieľa so zapnutým vyvolaním chyby. Kopíruje teda vyčísliteľné vlastné reťazcové a symbolové kľúče, nie zdedené ani nevyčísliteľné vlastnosti. Gettery, settery a pasce Proxy sa môžu spustiť alebo vyvolať výnimku.
Ide o plytkú kópiu hodnôt: deskriptory, prototyp ani vnorené objekty sa neklonujú. Operácia nie je transakčná — ak zápis do cieľa iba na čítanie či nerozšíriteľného cieľa alebo používateľský kód vyvolá výnimku, skoršie zápisy zostanú. Metóda existuje od ECMAScript 2015. Pri nedôveryhodných zdrojoch vyberaj povolené kľúče namiesto považovania assign za bezpečné zlúčenie.
Prí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ýsledok
get score true first 7 ok false true stop true false
Príklad ukazuje poradie zdrojov, getter, Symbol, vynechanú nevyčísliteľnú vlastnosť, zdieľanú referenciu a čiastočný zápis po chybe.