Node.js mixme

Merge multiple object recursively. The last object takes precedence over the previous ones. Only objects are merged. Arrays are overwritten.

API

The API is minimalist, pass as many literal objects as you wish, they will all be merged.

mixme({a: '1'}, {b: '2'});
// return {a: '1', b: '2'}

The default function exported is immutable. The source objects won't be altered. Use the mutate function to enrich an object. The first argument will be enriched:

obj = {a: '1'};
mixme.mutate(obj, {b: '2'});
// obj is now {a: '1', b: '2'}

It is possible to clone a literal object by simply calling mixme with this object as the first argument. Use the clone function in case you wish to clone any type of argument such as an array:

source = ['a', 'b']
target = mixme.clone(source)
// target is now a copy of source

Exemple

Merge an existing object with a second one:

obj1 = { a_key: 'a value', b_key: 'b value'};
obj2 = { b_key: 'new b value'};
result = misc.merge obj1, obj2
assert.eql result, obj1
assert.eql obj1.b_key, 'new b value'

Create a new object from two objects:

obj1 = { a_key: 'a value', b_key: 'b value'}
obj2 = { b_key: 'new b value'}
result = misc.merge {}, obj1, obj2
assert.eql result.b_key, 'new b value'

Testing

Clone the repo, install the development dependencies and run the tests:

git clone http://github.com/wdavidw/node-mixme.git .
npm install
make test

Contributors

• David Worms: https://github.com/wdavidw

This package is developed by Adaltas.