merge-value

merge-value

Similar to assign-value but deeply merges object values or nested values using object path/dot notation.

Install

Install with npm

$ npm i merge-value --save

Usage

var merge = require('merge-value');

var obj = {};
merge(obj, 'foo', {a: 'b'})
// obj.foo ==> {a: 'b'}

var obj = {foo: {a: 'b'}};
merge(obj, 'foo', {c: 'd'})
// obj.foo ==> {a: 'b', c: 'd'}

var obj = {};
merge(obj, 'a.b.c', {one: 'two'});
merge(obj, 'a.b.c', {three: 'four'});
// obj.a.b.c ==> {one: 'two', three: 'four'}

var obj = {foo: {bar: {baz: {a: 'b'}}}};
merge(obj, 'foo', {bar: {baz: {c: 'd'}}});
//=> {foo: {bar: {baz: {a: 'b', c: 'd'}}}}

Related projects

• assign-value: Extend a value or deeply nested property of an object using object path notation. | homepage
• get-value: Use property paths ( a.b.c) to get a nested value from an object. | homepage
• has-value: Returns true if a value exists, false if empty. Works with deeply nested values using… more | homepage
• set-value: Create nested values and any intermediaries using dot notation ('a.b.c') paths. | homepage
• union-value: Set an array of unique values as the property of an object. Supports setting deeply… more | homepage
• unset-value: Delete nested properties from an object using dot notation. | homepage

Running tests

Install dev dependencies:

$ npm i -d && npm test

Contributing

Pull requests and stars are always welcome. For bugs and feature requests, please create an issue.

Author

Jon Schlinkert

• github/jonschlinkert
• twitter/jonschlinkert

License

Copyright © 2015 Jon Schlinkert Released under the MIT license.

---

This file was generated by verb-cli on October 02, 2015.