A library to deep merge json files with array operations
npm install deepmerge-json
!GitHub tag (latest SemVer)
!npm
!Snyk Vulnerabilities for GitHub Repo
A simple library to deep merge json files with array operations. Hugely inspired by the awesome deepmerge project.
> Note that you can use to merge javascript objects, but the main reason this library was created was to merge json files with optional special operations for array merging.
Sometimes you need a deeply copied objects. Sometimes you need to alter these objects to make them more extensible and generic, specially when you are using convention over configuration or convention over code patterns.
The objective of this library is to help you with these situations being really simple, performatic and small (~1.5kb).
``js
let left = {
keep: 'keep',
simple: 10,
obj: { a: { multi: { level: 'property' } }, is: 'ok' },
merge: [0, 1, 2, 3],
append: [0, 1, 2],
prepend: [0, 1, 2]
};
let right = {
simple: 20,
obj: { a: { multi: { level: 'and' }, deep: 'property' } },
merge: [10, 20],
append: { $append: [3, 4, 5] },
prepend: { $prepend: [-2, -1] }
};
let result = merge(left, right);
console.log(result);
// Result
{
keep: 'keep',
simple: 20,
obj: { a: { multi: { level: 'and' }, deep: 'property' }, is: 'ok' },
merge: [10, 20, 2, 3],
append: [0, 1, 2, 3, 4, 5],
prepend: [-2, -1, 0, 1, 2]
}
`
Explanation: it deeply merges right object into left without altering them and their properties. Everything is cloned. Arrays elements are merged based on right parameters (operators) passed as objects.
`sh`
npm install deepmerge-json
After that you can import it:
`js`
import merge from 'deepmerge-json';
or
`js`
const merge = require('deepmerge-json');
There is even a Typescript d.ts definition file to support auto complete.
Just add this line to your HTML file:
`html