mirror of https://github.com/lukechilds/node.git
You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
38 lines
1.1 KiB
38 lines
1.1 KiB
9 years ago
|
var baseMerge = require('./_baseMerge'),
|
||
|
createAssigner = require('./_createAssigner');
|
||
|
|
||
|
/**
|
||
|
* Recursively merges own and inherited enumerable properties of source
|
||
|
* objects into the destination object, skipping source properties that resolve
|
||
|
* to `undefined`. Array and plain object properties are merged recursively.
|
||
|
* Other objects and value types are overridden by assignment. Source objects
|
||
|
* are applied from left to right. Subsequent sources overwrite property
|
||
|
* assignments of previous sources.
|
||
|
*
|
||
|
* **Note:** This method mutates `object`.
|
||
|
*
|
||
|
* @static
|
||
|
* @memberOf _
|
||
|
* @category Object
|
||
|
* @param {Object} object The destination object.
|
||
|
* @param {...Object} [sources] The source objects.
|
||
|
* @returns {Object} Returns `object`.
|
||
|
* @example
|
||
|
*
|
||
|
* var users = {
|
||
|
* 'data': [{ 'user': 'barney' }, { 'user': 'fred' }]
|
||
|
* };
|
||
|
*
|
||
|
* var ages = {
|
||
|
* 'data': [{ 'age': 36 }, { 'age': 40 }]
|
||
|
* };
|
||
|
*
|
||
|
* _.merge(users, ages);
|
||
|
* // => { 'data': [{ 'user': 'barney', 'age': 36 }, { 'user': 'fred', 'age': 40 }] }
|
||
|
*/
|
||
|
var merge = createAssigner(function(object, source, srcIndex) {
|
||
|
baseMerge(object, source, srcIndex);
|
||
|
});
|
||
|
|
||
|
module.exports = merge;
|