This package has been deprecated

Author message:

Package no longer supported. Contact Support at https://www.npmjs.com/support for more info.

diff-to-patch

A function that compares two JavaScript-objects and returns an array of JSON Patch-operations representing the difference between the two objects.

Install

npm install diff-to-patch

Usage

To use the function, simply require it and pass two objects you want to compare to it:

const diffToPatch = require('diff-to-patch');
 
diffToPatch({ foo: 'bar' }, { foo: 'baz' });
// => [{ op: 'replace', path: '/foo', value: 'baz' }]
 
diffToPatch({}, { foo: 'bar' });
// => [{ op: 'add', path: '/foo', value: 'bar' }]
 
diffToPatch({ foo: 'bar' }, {});
// => [{ op: 'remove', path: '/foo' }]
 
diffToPatch([1, 2, 3], [1, 2, 4]);
// => [{ op: 'replace', path: '/2', value: 4}]
 
diffToPatch([1, 2, 3], [1, 2, 3, 4]);
// => [{ op: 'add', path: '/3', value: 4}]
 
diffToPatch([1, 2, 3], [1, 2]);
// => [{ op: 'remove', path: '/2'}]

You can pass objects with arbitrary complexity:

 
let objA = {
    name: 'Bob',
    age: 25,
    address: {
        street: '468 Ash Street',
        city: 'Bedias, South Carolina',
        zipCode: '1669'
    },
    phoneNumbers: [
        '[phone]',
        '[phone]'
    ]
};
 
let objB = {
    name: 'Bobby',
    age: 26,
    address: {
        street: '468 Ash Street',
        city: 'Bedias, South Carolina',
        zipCode: '1669'
    },
    phoneNumbers: [
        '[phone]'
    ],
    email: '[e-mail]'
}
 
diffToPatch(objA, objB);
/*
    => [
        { op: 'replace', path: '/name', value: 'Bobby' },
        { op: 'replace', path: '/age', value: 26 },
        { op: 'remove', path: '/phoneNumbers/1' },
        { op: 'add', path: '/email', value: '[e-mail]' }
    ]
*/

The function validates the input arguments and throws a NoValidInputJSONError if at least one of the input arguments...

• ...is null or undefined
• ...is of a primitive type (string, boolean, number)
• ...is an object that is not valid JSON (i.e. a function)
• ...contains a circular reference
• ...does not have the same type as the other input argument