CKTIS / JavaScript
Object.assign: eigene Werte kopieren
Object.assign kopiert aufzählbare eigene Eigenschaftswerte aus Quellen in ein Zielobjekt.
Version: ECMAScript 2015 onward; example target: Node.js 24.22.2
Syntax
Object.assign(target, ...sources)Object.assign(target, ...sources) wendet zuerst ToObject auf target an: null und undefined werfen TypeError, ein primitives Ziel wird verpackt und als Objekt zurückgegeben. Quellen werden von links nach rechts verarbeitet; null und undefined werden übersprungen, andere primitive Werte verpackt. Eine spätere Quelle kann einen früheren Wert überschreiben.
Für jede Quelle nimmt der Algorithmus eine OwnPropertyKeys-Momentaufnahme. Für jeden Schlüssel prüft er danach den aktuellen eigenen Deskriptor und führt bei Aufzählbarkeit Get an der Quelle sowie Set am Ziel mit aktivem Werfen aus. Kopiert werden also aufzählbare eigene String- und Symbolschlüssel, nicht aber geerbte oder nicht aufzählbare Eigenschaften. Getter, Setter und Proxy-Fallen können laufen oder werfen.
Dies ist eine flache Wertekopie: Deskriptoren, Prototyp und verschachtelte Objekte werden nicht geklont. Der Vorgang ist nicht transaktional—werfen ein Schreibzugriff auf ein schreibgeschütztes oder nicht erweiterbares Ziel oder Benutzercode, bleiben frühere Schreibvorgänge bestehen. Die Methode existiert seit ECMAScript 2015. Wähle bei nicht vertrauenswürdigen Quellen erlaubte Schlüssel, statt assign als sicheres Zusammenführen zu behandeln.
Beispiele
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"));
}Ergebnis
get score true first 7 ok false true stop true false
Das Beispiel zeigt Quellenreihenfolge, Getter, Symbol, ausgelassene nicht aufzählbare Eigenschaft, gemeinsame Referenz und Teilschreibvorgang nach Fehler.