Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/mattphillips/deep-object-diff
Deep diffs two objects, including nested structures of arrays and objects, and returns the difference. ❄️
https://github.com/mattphillips/deep-object-diff
array deep diff nested-structures object
Last synced: about 2 months ago
JSON representation
Deep diffs two objects, including nested structures of arrays and objects, and returns the difference. ❄️
- Host: GitHub
- URL: https://github.com/mattphillips/deep-object-diff
- Owner: mattphillips
- License: mit
- Created: 2016-11-25T00:34:54.000Z (almost 8 years ago)
- Default Branch: main
- Last Pushed: 2024-03-04T12:06:22.000Z (7 months ago)
- Last Synced: 2024-07-19T14:14:06.635Z (2 months ago)
- Topics: array, deep, diff, nested-structures, object
- Language: JavaScript
- Homepage: https://www.npmjs.com/package/deep-object-diff
- Size: 178 KB
- Stars: 1,027
- Watchers: 11
- Forks: 87
- Open Issues: 33
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
- awesome-star-libs - mattphillips / deep-object-diff
README
deep-object-diff
❄️
Deep diff two JavaScript Objects
[](https://github.com/mattphillips/deep-object-diff/actions/workflows/ci.yaml)
[](https://codecov.io/gh/mattphillips/deep-object-diff)
[](https://www.npmjs.com/package/deep-object-diff)
[](http://npm-stat.com/charts.html?package=deep-object-diff&from=2016-11-23)
[](https://github.com/mattphillips/deep-object-diff/blob/master/LICENSE)
[](http://makeapullrequest.com)
A small library that can deep diff two JavaScript Objects, including nested structures of arrays and objects.
## Installation
`yarn add deep-object-diff`
`npm i --save deep-object-diff`
## Functions available:
- [`diff(originalObj, updatedObj)`](#diff)
returns the difference of the original and updated objects
- [`addedDiff(original, updatedObj)`](#addeddiff)
returns only the values added to the updated object
- [`deletedDiff(original, updatedObj)`](#deleteddiff)
returns only the values deleted in the updated object
- [`updatedDiff(original, updatedObj)`](#updateddiff)
returns only the values that have been changed in the updated object
- [`detailedDiff(original, updatedObj)`](#detaileddiff)
returns an object with the added, deleted and updated differences
## Importing
``` js
import { diff, addedDiff, deletedDiff, updatedDiff, detailedDiff } from 'deep-object-diff';
```
## Usage:
### `diff`:
```js
const lhs = {
foo: {
bar: {
a: ['a', 'b'],
b: 2,
c: ['x', 'y'],
e: 100 // deleted
}
},
buzz: 'world'
};
const rhs = {
foo: {
bar: {
a: ['a'], // index 1 ('b') deleted
b: 2, // unchanged
c: ['x', 'y', 'z'], // 'z' added
d: 'Hello, world!' // added
}
},
buzz: 'fizz' // updated
};
console.log(diff(lhs, rhs)); // =>
/*
{
foo: {
bar: {
a: {
'1': undefined
},
c: {
'2': 'z'
},
d: 'Hello, world!',
e: undefined
}
},
buzz: 'fizz'
}
*/
```
### `addedDiff`:
```js
const lhs = {
foo: {
bar: {
a: ['a', 'b'],
b: 2,
c: ['x', 'y'],
e: 100 // deleted
}
},
buzz: 'world'
};
const rhs = {
foo: {
bar: {
a: ['a'], // index 1 ('b') deleted
b: 2, // unchanged
c: ['x', 'y', 'z'], // 'z' added
d: 'Hello, world!' // added
}
},
buzz: 'fizz' // updated
};
console.log(addedDiff(lhs, rhs));
/*
{
foo: {
bar: {
c: {
'2': 'z'
},
d: 'Hello, world!'
}
}
}
*/
```
### `deletedDiff`:
```js
const lhs = {
foo: {
bar: {
a: ['a', 'b'],
b: 2,
c: ['x', 'y'],
e: 100 // deleted
}
},
buzz: 'world'
};
const rhs = {
foo: {
bar: {
a: ['a'], // index 1 ('b') deleted
b: 2, // unchanged
c: ['x', 'y', 'z'], // 'z' added
d: 'Hello, world!' // added
}
},
buzz: 'fizz' // updated
};
console.log(deletedDiff(lhs, rhs));
/*
{
foo: {
bar: {
a: {
'1': undefined
},
e: undefined
}
}
}
*/
```
### `updatedDiff`:
```js
const lhs = {
foo: {
bar: {
a: ['a', 'b'],
b: 2,
c: ['x', 'y'],
e: 100 // deleted
}
},
buzz: 'world'
};
const rhs = {
foo: {
bar: {
a: ['a'], // index 1 ('b') deleted
b: 2, // unchanged
c: ['x', 'y', 'z'], // 'z' added
d: 'Hello, world!' // added
}
},
buzz: 'fizz' // updated
};
console.log(updatedDiff(lhs, rhs));
/*
{
buzz: 'fizz'
}
*/
```
### `detailedDiff`:
```js
const lhs = {
foo: {
bar: {
a: ['a', 'b'],
b: 2,
c: ['x', 'y'],
e: 100 // deleted
}
},
buzz: 'world'
};
const rhs = {
foo: {
bar: {
a: ['a'], // index 1 ('b') deleted
b: 2, // unchanged
c: ['x', 'y', 'z'], // 'z' added
d: 'Hello, world!' // added
}
},
buzz: 'fizz' // updated
};
console.log(detailedDiff(lhs, rhs));
/*
{
added: {
foo: {
bar: {
c: {
'2': 'z'
},
d: 'Hello, world!'
}
}
},
deleted: {
foo: {
bar: {
a: {
'1': undefined
},
e: undefined
}
}
},
updated: {
buzz: 'fizz'
}
}
*/
```
## License
MIT