CKTIS / JavaScript
Object.assign: kopiranje lastnih vrednosti
Object.assign kopira vrednosti naštevnih lastnih lastnosti iz virov v en ciljni objekt.
Različica: ECMAScript 2015 onward; example target: Node.js 24.22.2
Sintaksa
Object.assign(target, ...sources)Object.assign(target, ...sources) najprej uporabi ToObject za target: null in undefined sprožita TypeError, primitiven cilj pa se ovije in vrne kot objekt. Viri se obdelajo od leve proti desni; null in undefined se preskočita, druge primitivne vrednosti se ovijejo. Poznejši vir lahko prepiše prejšnjo vrednost.
Za vsak vir algoritem zajame posnetek OwnPropertyKeys. Za vsak ključ nato preveri trenutni lastni deskriptor in, če je našteven, izvede Get na viru ter Set na cilju z omogočenim sprožanjem napak. Kopira torej naštevne lastne besedilne in simbolne ključe, ne pa podedovanih ali nenaštevnih lastnosti. Getterji, setterji in pasti Proxy se lahko izvedejo ali sprožijo izjemo.
To je plitva kopija vrednosti: deskriptorji, prototip in ugnezdeni objekti se ne klonirajo. Operacija ni transakcijska — če pisanje v samo-bralni ali nerazširljivi cilj ali uporabniška koda sproži izjemo, prejšnji zapisi ostanejo. Metoda obstaja od ECMAScript 2015. Pri nezaupanja vrednih virih izberi dovoljene ključe, namesto da bi assign obravnaval kot varno združevanje.
Primeri
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"));
}Rezultat
get score true first 7 ok false true stop true false
Primer pokaže vrstni red virov, getter, Symbol, izpuščeno nenaštevno lastnost, skupno referenco in delni zapis po napaki.