CKTIS / JavaScript
Object.assign: kopiowanie własnych wartości
Object.assign kopiuje wyliczalne własne wartości właściwości ze źródeł do jednego obiektu docelowego.
Wersja: ECMAScript 2015 onward; example target: Node.js 24.22.2
Składnia
Object.assign(target, ...sources)Object.assign(target, ...sources) najpierw stosuje ToObject do target, więc null i undefined powodują TypeError, a cel pierwotny jest opakowywany i zwracany jako obiekt. Źródła są przetwarzane od lewej do prawej; null i undefined są pomijane, a inne wartości pierwotne są opakowywane. Późniejsze źródło może nadpisać wcześniejszą wartość.
Dla każdego źródła algorytm pobiera migawkę OwnPropertyKeys. Następnie dla każdego klucza sprawdza bieżący własny deskryptor i, jeśli jest wyliczalny, wykonuje Get ze źródła oraz Set na celu z włączonym rzucaniem błędów. Kopiowane są więc wyliczalne własne klucze tekstowe i symboliczne, ale nie właściwości dziedziczone ani niewyliczalne. Gettery, settery i pułapki Proxy mogą się wykonać lub rzucić.
To płytkie kopiowanie wartości: nie klonuje deskryptorów, prototypu ani obiektów zagnieżdżonych. Operacja nie jest transakcyjna — jeśli zapis do tylko-do-odczytu lub nierozszerzalnego celu albo kod użytkownika rzuci, wcześniejsze zapisy pozostają. Metoda istnieje od ECMAScript 2015. Przy nieufnych źródłach wybieraj dozwolone klucze zamiast traktować assign jako bezpieczne scalanie.
Przykłady
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"));
}Wynik
get score true first 7 ok false true stop true false
Przykład pokazuje kolejność źródeł, getter, Symbol, pominięcie właściwości niewyliczalnej, wspólną referencję i częściowy zapis po błędzie.