Cette page a été traduite à partir de l'anglais par la communauté.Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.
Object.assign()
Baseline Widely available
Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis septembre 2015.
La méthodeObject.assign() est utilisée afin de copier les valeurs de toutes les propriétés directes (non héritées) d'un objet qui sont énumérables sur un autre objet cible. Cette méthode renvoie l'objet cible.
Exemple interactif
const target = { a: 1, b: 2 };const source = { b: 4, c: 5 };const returnedTarget = Object.assign(target, source);console.log(target);// Expected output: Object { a: 1, b: 4, c: 5 }console.log(returnedTarget === target);// Expected output: trueSyntaxe
Object.assign(cible, ...sources);Paramètres
Valeur de retour
L'objet cible, éventuellement modifié, est renvoyé.
Description
La méthodeObject.assign permet de ne copier que les propriétés énumérables et propres (les propriétés qui ne sont pas héritées) depuis un objet source vers un objet cible. Elle utilise[[Get]] sur l'objet source et[[Set]] sur l'objet cible, ainsi, elle déclenchera les accesseurs/mutateurs. De cette façon, elleaffecte les propriétés plutôt que de juste les copier ou d'en définir de nouvelles. Aussi, il est déconseillé d'utiliser cette méthode si on souhaite uniquement fusionner de nouvelles propriétés dans un prototype si un des objets sources contient des accesseurs. Pour uniquement copier les définitions des propriétés (y compris leur énumérabilité) dans des prototypes, on utilisera plutôtObject.getOwnPropertyDescriptor() etObject.defineProperty().
Les propriétésString etSymbol sont copiées. Les propriétés de l'objet cible sont surchargées par celles de l'objet source si elles ont la même clé.
En cas d'erreur, si une propriété n'est pas accessible en écriture par exemple, une exceptionTypeError sera levée mais l'objet cible aura été modifié avec les propriétés ajoutées avant l'erreur.
Object.assign ne donnera pas d'erreur si on fournit les valeursnull ouundefined pour la valeur source.
Exemples
Cloner un objet
var obj = { a: 1 };var copie = Object.assign({}, obj);console.log(copie); // {a: 1}Note :Attention, pour un clone réel (deep clone), il faudra utiliser d'autres méthodes carObject.assign() ne copie que les valeurs des propriétés depuis l'objet source, il ne recopie pas intégralement une nouvelle propriété. Si la valeur est une référence à un objet, il copiera uniquement la référence.
Fusionner des objets
var o1 = { a: 1 };var o2 = { b: 2 };var o3 = { c: 3 };var obj = Object.assign(o1, o2, o3);console.log(obj); // { a: 1, b: 2, c: 3 }console.log(o1); // { a: 1, b: 2, c: 3 }, l'objet cible est aussi modifiéFusionner des objets partageant des propriétés
var o1 = { a: 1, b: 1, c: 1 };var o2 = { b: 2, c: 2 };var o3 = { c: 3 };var obj = Object.assign({}, o1, o2, o3);console.log(obj); // { a: 1, b: 2, c: 3 }Les propriétés communes sont surchargées selon l'ordre des paramètres.
Copier des propriétés symboliques
var o1 = { a: 1 };var o2 = { [Symbol("toto")]: 2 };var obj = Object.assign({}, o1, o2);console.log(obj); // { a: 1, [Symbol("toto")]: 2 }// Attention : dans Firefox le symbole n'est pas affiché// en raison du bug 1207182console.log(Object.getOwnPropertySymbols(obj)); // [Symbol(toto)]Les propriétés héritées et les propriétés non-énumérables ne peuvent être copiées
var obj = Object.create( { toto: 1 }, { // toto est héritée truc: { value: 2, // truc est non-enumerable (par défaut) }, bidule: { value: 3, enumerable: true, // bidule est une propriété propre et énumérable }, },);var copie = Object.assign({}, obj);console.log(copie); // { bidule: 3 }Les types primitifs seront passés en objets
var v1 = "abc";var v2 = true;var v3 = 10;var v4 = Symbol("toto");var obj = Object.assign({}, v1, null, v2, undefined, v3, v4);// Les valeurs primitives seront converties, null et undefined seront ignorés.// Note : seules les chaînes peuvent avoir des propriétés énumérables.console.log(obj); // { "0": "a", "1": "b", "2": "c" }Les exceptions interrompent la copie
var target = Object.defineProperty({}, "toto", { value: 1, writable: false,}); // target.toto est en lecture seuleObject.assign( target, { truc: 2 }, { toto2: 3, toto: 3, toto3: 3 }, { bidule: 4 },);// TypeError: "toto" est en lecture seule// L'exception est levée lorsqu'on affecte target.totoconsole.log(target.truc); // 2, le premier objet source est bien copiéconsole.log(target.toto2); // 3, la première propriété du deuxième objet source est bien copiéeconsole.log(target.toto); // 1, on a une exception iciconsole.log(target.toto3); // undefined, assign est terminé toto3 ne sera pas copiéconsole.log(target.bidule); // undefined, le troisième objet source ne sera pas copié non plus.Copier des accesseurs
var obj = { toto: 1, get truc() { return 2; },};var copie = Object.assign({}, obj);console.log(copie);// { toto: 1, truc: 2 }, la valeur de copie.truc// est la valeur renvoyée par l'accesseur d'obj.truc.// Voici une fonction qui copie les descripteurs// dans leur intégralitéfunction completeAssign(target, ...sources) { sources.forEach((source) => { let descriptors = Object.keys(source).reduce((descriptors, key) => { descriptors[key] = Object.getOwnPropertyDescriptor(source, key); return descriptors; }, {}); // Par défaut, Object.assign copie également // les symboles énumérables Object.getOwnPropertySymbols(source).forEach((sym) => { let descriptor = Object.getOwnPropertyDescriptor(source, sym); if (descriptor.enumerable) { descriptors[sym] = descriptor; } }); Object.defineProperties(target, descriptors); }); return target;}var copie = completeAssign({}, obj);console.log(copie);// { toto:1, get truc() { return 2 } }Spécifications
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-object.assign |
Compatibilité des navigateurs
Chargement…