merge-deep
Advanced tools
The merge-deep npm package is a utility for deeply merging objects in JavaScript. It is useful for combining configurations, options, or states in a way that nested properties are not lost but instead merged together.
Deep merging of objects
This feature allows you to deeply merge multiple objects into one. It recursively merges own and inherited enumerable properties of source objects into the destination object, skipping source properties that resolve to `undefined`.
{"const mergeDeep = require('merge-deep');\nconst object1 = { a: { b: 1 } };\nconst object2 = { a: { c: 2 }, d: 3 };\nconst result = mergeDeep(object1, object2);\nconsole.log(result); // Output: { a: { b: 1, c: 2 }, d: 3 }"}Merging with array concatenation
Merge-deep can also merge arrays by concatenating them. This is useful when you want to combine arrays from different objects without losing any elements.
{"const mergeDeep = require('merge-deep');\nconst object1 = { a: [1, 2], b: 'one' };\nconst object2 = { a: [3, 4], b: 'two' };\nconst result = mergeDeep(object1, object2);\nconsole.log(result); // Output: { a: [1, 2, 3, 4], b: 'two' }"}Customizing merge behavior
Users can define a custom merge function to control how merging is done. This is particularly useful when the default behavior of merge-deep does not suit the specific needs of your application.
{"const mergeDeep = require('merge-deep');\nfunction customMerge(a, b) {\n return Array.isArray(a) ? a.concat(b) : undefined;\n}\nconst object1 = { a: [1], b: [2] };\nconst object2 = { a: [3], b: [4] };\nconst result = mergeDeep({ customMerge }, object1, object2);\nconsole.log(result); // Output: { a: [1, 3], b: [2, 4] }"}Lodash's merge function is similar to merge-deep as it allows for deep merging of objects. Lodash is a larger utility library, and its merge function is one of many utilities it provides. It is well-tested and widely used in the JavaScript community.
Deepmerge is another npm package that provides deep merging capabilities. It is similar to merge-deep but offers additional options for customizing the merge behavior, such as whether to clone or not clone the source objects, and how to handle merging arrays.
The extend package is a port of the jQuery extend method that can also perform deep merging of objects. It is less specialized than merge-deep and deepmerge, but it is still a viable option for users who prefer a jQuery-like API.
Recursively merge values in a javascript object.
Please consider following this project's author, Jon Schlinkert, and consider starring the project to show your :heart: and support.
Install with npm:
$ npm install --save merge-deep
Based on mout's implementation of merge
var merge = require('merge-deep');
merge({a: {b: {c: 'c', d: 'd'}}}, {a: {b: {e: 'e', f: 'f'}}});
//=> { a: { b: { c: 'c', d: 'd', e: 'e', f: 'f' } } }
Pull requests and stars are always welcome. For bugs and feature requests, please create an issue.
Running and reviewing unit tests is a great way to get familiarized with a library and its API. You can install dependencies and run tests with the following command:
$ npm install && npm test
(This project's readme.md is generated by verb, please don't edit the readme directly. Any changes to the readme must be made in the .verb.md readme template.)
To generate the readme, run the following command:
$ npm install -g verbose/verb#dev verb-generate-readme && verb
You might also be interested in these projects:
extend but recursively copies only the missing properties/values to the target object. | homepage| Commits | Contributor |
|---|---|
| 32 | jonschlinkert |
| 8 | doowb |
Jon Schlinkert
Copyright © 2021, Jon Schlinkert. Released under the MIT License.
This file was generated by verb-generate-readme, v0.8.0, on January 11, 2021.
FAQs
Recursively merge values in a javascript object.
The npm package merge-deep receives a total of 934,870 weekly downloads. As such, merge-deep popularity was classified as popular.
We found that merge-deep demonstrated a not healthy version release cadence and project activity because the last version was released a year ago. It has 2 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
PyPI confirms no security flaws were exploited in the Ultralytics supply chain attack and highlights improvements for safer package publishing.
Security News
Research
The Socket Research Team breaks down a malicious wrapper package that uses obfuscation to harvest credentials and exfiltrate sensitive data.
Research
Security News
Attackers used a malicious npm package typosquatting a popular ESLint plugin to steal sensitive data, execute commands, and exploit developer systems.