mixin-deep

What is mixin-deep?

The mixin-deep package is a utility for deeply mixing the properties of objects into the first object. It is useful for merging objects with nested properties, allowing for deep assignment and merging of object properties, arrays, and other nested structures.

What are mixin-deep's main functionalities?

Deep Merging of Objects

This feature allows for the deep merging of objects, including nested properties. The code sample demonstrates merging two objects with nested properties, resulting in a single object that combines both.

{"const mixinDeep = require('mixin-deep');\nconst object1 = { a: { b: { c: 1 } } };\nconst object2 = { a: { b: { d: 2 }, e: 3 } };\nconst result = mixinDeep(object1, object2);\nconsole.log(result); // Output: { a: { b: { c: 1, d: 2 }, e: 3 } }"}

Merging Arrays and Objects

This feature demonstrates how mixin-deep can merge both arrays and objects. The arrays are replaced rather than merged, while the objects are deeply merged.

{"const mixinDeep = require('mixin-deep');\nconst object1 = { a: [1, 2], b: { c: 1 } };\nconst object2 = { a: [3, 4], b: { d: 2 } };\nconst result = mixinDeep(object1, object2);\nconsole.log(result); // Output: { a: [3, 4], b: { c: 1, d: 2 } }"}

Other packages similar to mixin-deep

lodash.merge

Lodash's merge function offers similar deep merging capabilities. It recursively merges own and inherited enumerable string keyed properties of source objects into the destination object. Compared to mixin-deep, lodash.merge is part of the larger lodash utility library, which provides a wide range of functions for manipulating objects, arrays, strings, etc.

deepmerge

The deepmerge package is another alternative that provides a simple and effective way to deeply merge objects in JavaScript. It is similar to mixin-deep but offers additional options for customizing the merge behavior, such as array merging strategies and cloning.

README

mixin-deep

Deeply mix the properties of objects into the first object, while also mixing-in child objects.

Install

Install with npm:

npm i mixin-deep --save-dev

Run tests

npm test

Usage

var mixinDeep = require('mixin-deep');

mixinDeep({a: {aa: 'aa'}}, {a: {bb: 'bb'}}, {a: {cc: 'cc'}});
//=> { a: { aa: 'aa', bb: 'bb', cc: 'cc' } }

mixinDeep({a: {aa: 'aa', dd: {ee: 'ff'}}}, {a: {bb: 'bb', dd: {gg: 'hh'}}}, {a: {cc: 'cc', dd: {ii: 'jj'}}});
//=> { a: { aa: 'aa', dd: { ee: 'ff', gg: 'hh', ii: 'jj' }, bb: 'bb', cc: 'cc' } }

Author

Jon Schlinkert

• github/jonschlinkert
• twitter/jonschlinkert

License

Copyright (c) 2014 Jon Schlinkert, contributors.
Released under the MIT license

---

This file was generated by verb-cli on September 22, 2014.