Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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.

Zdroje