@darkkenergy/extend

Extend

Object extending algorithm for any number of object (shallow copy).

Install

npm i @darkkenergy/extend -S

Inclusion

// CommonJS
var Extend = require('@darkkenergy/extend');

// ES6
import Extend from '@darkkenergy/extend';

Usage

/**
 * @name Extend
 * @version 1.0.5
 * @author Claudio Nuñez Jr.
 * @desc Merge multiple objects into one.
 *      Accepts any number of objects as parameters.
 * 
 * @param [n-arguments] {objects} :Any number of objects to merge together.
 * 
 * @return {object|undefined} :The extended object or undefined if no arguments
 *  were passed.
 */

// Extend([objectLiteral, ][...objectLiteral])

var Extend = require('@darkkenergy/extend');

Example:

var objFirst = { one: "1", two: "2" };
var objLast = { two: "4", three: "3" };

var obj = Extend({}, objFirst, objLast);
// Outputs: { one: "1", two: "4", three: "3" }