CKTIS / JavaScript
Object.assign: copiare valori propri
Object.assign copia i valori delle proprietà proprie enumerabili dalle sorgenti in un oggetto destinazione.
Versione: ECMAScript 2015 onward; example target: Node.js 24.22.2
Sintassi
Object.assign(target, ...sources)Object.assign(target, ...sources) applica prima ToObject a target: null e undefined generano TypeError, mentre una destinazione primitiva viene boxed e restituita come oggetto. Le sorgenti sono elaborate da sinistra a destra; null e undefined sono saltati, le altre primitive sono boxed. Una sorgente successiva può sovrascrivere un valore precedente.
Per ogni sorgente l’algoritmo acquisisce un’istantanea OwnPropertyKeys. Per ogni chiave controlla poi il descrittore proprio corrente e, se enumerabile, esegue Get sulla sorgente e Set sulla destinazione con lancio degli errori attivo. Copia quindi chiavi proprie enumerabili stringa e simbolo, ma non proprietà ereditate o non enumerabili. Getter, setter e trap Proxy possono essere eseguiti o generare eccezioni.
È una copia superficiale dei valori: descrittori, prototipo e oggetti annidati non sono clonati. L’operazione non è transazionale: se la scrittura su una destinazione di sola lettura o non estensibile, o il codice utente, genera un’eccezione, le scritture precedenti restano. Il metodo esiste da ECMAScript 2015. Con sorgenti non affidabili seleziona le chiavi consentite invece di considerare assign una fusione sicura.
Esempi
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"));
}Risultato
get score true first 7 ok false true stop true false
L’esempio mostra ordine delle sorgenti, getter, Symbol, proprietà non enumerabile omessa, riferimento condiviso e scrittura parziale dopo un errore.