CKTIS / JavaScript
Object.assign: eigen waarden kopiëren
Object.assign kopieert waarden van opsombare eigen eigenschappen uit bronnen naar één doelobject.
Versie: ECMAScript 2015 onward; example target: Node.js 24.22.2
Syntax
Object.assign(target, ...sources)Object.assign(target, ...sources) past eerst ToObject toe op target: null en undefined werpen TypeError, terwijl een primitief doel wordt ingepakt en als object teruggegeven. Bronnen worden van links naar rechts verwerkt; null en undefined worden overgeslagen, andere primitieve waarden ingepakt. Een latere bron kan een eerdere waarde overschrijven.
Voor elke bron neemt het algoritme een OwnPropertyKeys-momentopname. Voor elke sleutel controleert het daarna de huidige eigen descriptor en voert, indien opsombaar, Get op de bron en Set op het doel uit met werpen ingeschakeld. Het kopieert dus opsombare eigen string- en symboolsleutels, maar geen geërfde of niet-opsombare eigenschappen. Getters, setters en Proxy-traps kunnen uitvoeren of werpen.
Dit is een ondiepe waardekopie: descriptors, prototype en geneste objecten worden niet gekloond. De bewerking is niet transactioneel—als schrijven naar een alleen-lezen of niet-uitbreidbaar doel, of gebruikerscode, werpt, blijven eerdere schrijfacties staan. De methode bestaat sinds ECMAScript 2015. Selecteer bij onbetrouwbare bronnen toegestane sleutels in plaats van assign als veilige samenvoeging te beschouwen.
Voorbeelden
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"));
}Resultaat
get score true first 7 ok false true stop true false
Het voorbeeld toont bronvolgorde, getter, Symbol, overgeslagen niet-opsombare eigenschap, gedeelde referentie en gedeeltelijke schrijfactie na een fout.