Saman(समान) is a deep object diffing and equality checker for Javascript. The library is concise consisting of only 6 functions and the distribution size is 659 bytes(Gzipped).
const { equal, diff2 } = require("saman"); let obj1 = { i:10, j:-3, y:[-1,-3] }; let obj2 = { r:76, e:23, i:4, y:[1,2,-7] }; let obj3 = { m: "hello", n:"bye" }; console.log(equal(obj3,obj3)); // -> True console.log(diff2(obj1,obj2)); // -> /* { created: { r: 76, e: 23, y: { '2': -7 } }, updated: { i: 4, y: { '0': 1, '1': 2 } }, deleted: { j: -3 } } */npm i saman <script src="https://unpkg.com/saman"></script> Underconstruction!
This function recursively checks every property of both the objects for equality and returns a boolean.
const { equal } = require("saman"); const obj1 = { x:10, y:20 }; const obj2 = { x:-1, y:2 }; console.log(equal(obj1,obj2)) // -> false console.log(equal(obj1,obj1)) // -> true console.log(equal(obj2,obj2)) // -> trueThis function recursively checks and reports every new property created in obj2 w.r.t.obj1 and returns an object which contains all the newly created props.
const { cDiff } = require("saman"); const obj1 = { x:10, y:20 }; const obj2 = { x:-1, y:2, z:30 }; console.log(cDiff(obj1,obj2)) // -> { z:30 }This function recursively checks and reports every updated property in obj2 w.r.t.obj1 and returns an object which contains all the updated props.
const { uDiff } = require("saman"); const obj1 = { x:10, y:20 }; const obj2 = { x:10, y:-7, z:30 }; console.log(uDiff(obj1,obj2)) // -> { y:-7 }This function recursively checks and reports every deleted property in obj2 w.r.t.obj1 and returns an object which contains all the deleted props.
const { dDiff } = require("saman"); const obj1 = { x:10, y:20 }; const obj2 = { y:-7 }; console.log(dDiff(obj1,obj2)) // -> { x:10 } console.log(dDiff(obj1,obj1)) // -> {}This function recursively checks and reports every created, updated and deleted properties in obj2 w.r.t.obj1 and returns an object which contains all the created, updated and deleted props.
const { diff } = require("saman"); const obj1 = { x:10, y:20, z:30 }; const obj2 = { x:2, y:-7 }; console.log(diff(obj1,obj2)) // -> { x:2, y:-7, z:30 }This function is similar to saman.diff but instead of returning created, updated and deleted props all-together merged in one object without delineation, saman.diff2 returns an object with 3 props: created, updated and deleted which contain those props respectively.
const { diff2 } = require("saman"); const obj1 = { x:10, y:20, z:30 }; const obj2 = { x:2, y:-7 }; console.log(diff2(obj1,obj2)) // -> { created:{}, updated: {x:2, y:-7}, deleted: {z:30} }