extend() pour Node.js

node-extend est un port de la méthode classique extend() de jQuery. Il se comporte comme prévu. C'est simple, éprouvé et fiable.

Remarques :

• Depuis Node.js >= 4, Object.assign offre désormais la même fonctionnalité de manière native (mais sans l'option de « copie profonde »). Voir ECMAScript 2015 (ES6) dans Node.js.
• Certaines implémentations natives de Object.assign dans Node.js et de nombreux navigateurs (car les modules NPM sont aussi pour le navigateur) peuvent ne pas être entièrement conformes aux spécifications. Consultez le module object.assign pour un candidat conforme.

Installation

Ce package est disponible sur npm sous le nom : extend

npm install extend

Utilisation

Syntaxe : extend ( [deep], target, object1, [objectN] )

Étend un objet avec un ou plusieurs autres, et renvoie l'objet modifié.

Exemple :

var extend = require('extend');
extend(targetObject, object1, object2);

Gardez à l'esprit que l'objet cible sera modifié, et sera renvoyé par extend().

Si un booléen true est spécifié comme premier argument, extend effectue une copie profonde, en copiant récursivement tous les objets qu'il trouve. Sinon, la copie partagera la structure avec le ou les objets originaux. Les propriétés non définies ne sont pas copiées. Cependant, les propriétés héritées du prototype de l'objet seront copiées. Attention : passer false comme premier argument n'est pas pris en charge.

Arguments

• deep Boolean (optionnel) Si défini, la fusion devient récursive (c'est-à-dire copie profonde).
• target Object L'objet à étendre.
• object1 Object L'objet qui sera fusionné dans le premier.
• objectN Object (Optionnel) D'autres objets à fusionner dans le premier.

Licence

node-extend est sous licence MIT License.

Remerciements

Tout le crédit revient aux auteurs de jQuery pour avoir perfectionné cet utilitaire exceptionnel.

Porté vers Node.js par Stefan Thomas avec les contributions de Jonathan Buchanan et Jordan Harband.