Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

Object.assign : copier les valeurs propres

Object.assign copie les valeurs des propriétés propres énumérables de sources vers un même objet cible.

Version : ECMAScript 2015 onward; example target: Node.js 24.22.2

Syntaxe

Object.assign(target, ...sources)

Object.assign(target, ...sources) applique d’abord ToObject à target : null et undefined lèvent TypeError, tandis qu’une cible primitive est encapsulée et renvoyée comme objet. Les sources sont traitées de gauche à droite ; null et undefined sont ignorés, les autres primitives sont encapsulées. Une source ultérieure peut écraser une valeur antérieure.

Pour chaque source, l’algorithme prend un instantané OwnPropertyKeys. Pour chaque clé, il vérifie ensuite le descripteur propre courant et, s’il est énumérable, effectue Get sur la source puis Set sur la cible avec levée d’erreur activée. Il copie donc les clés propres énumérables de type chaîne et symbole, mais ni les propriétés héritées ni celles non énumérables. Getters, setters et pièges Proxy peuvent s’exécuter ou lever une exception.

C’est une copie superficielle de valeurs : descripteurs, prototype et objets imbriqués ne sont pas clonés. L’opération n’est pas transactionnelle — si l’écriture dans une cible en lecture seule ou non extensible, ou du code utilisateur, lève une exception, les écritures précédentes restent. La méthode existe depuis ECMAScript 2015. Avec des sources non fiables, sélectionne les clés autorisées au lieu de considérer assign comme une fusion sûre.

Exemples

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"));
}

Résultat

get score
true first 7 ok false
true
stop true false

L’exemple montre ordre des sources, getter, Symbol, propriété non énumérable omise, référence partagée et écriture partielle après erreur.

Sources