Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

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.

Viri