deep-equal

What is deep-equal?

The deep-equal npm package is a library for performing deep equality checks between two values. It is useful for comparing objects, arrays, and other nested structures to determine if they are equivalent in structure and content, regardless of whether they are the same reference in memory.

What are deep-equal's main functionalities?

Deep comparison of objects and arrays

This feature allows you to compare objects and arrays to see if they are structurally identical, even if they are different instances.

const deepEqual = require('deep-equal');

const obj1 = { a: 1, b: { c: 1 } };
const obj2 = { a: 1, b: { c: 1 } };

console.log(deepEqual(obj1, obj2)); // true

Comparison with custom options

This feature allows you to specify options for the comparison, such as strict mode, which requires the values to be of the same type as well.

const deepEqual = require('deep-equal');

const obj1 = { a: 1 };
const obj2 = { a: '1' };
const options = { strict: true };

console.log(deepEqual(obj1, obj2, options)); // false

Other packages similar to deep-equal

lodash.isequal

Lodash provides a method called isEqual which can perform deep comparisons between two values. It is part of the larger Lodash utility library, which offers a wide range of functions for manipulating and comparing data.

fast-deep-equal

This package offers a fast deep equality comparison algorithm. It is known for its performance and is a good choice when speed is a critical factor.

README

deep-equal

Node's assert.deepEqual() algorithm as a standalone module.

This module is around 46 times faster than wrapping assert.deepEqual() in a try/catch.

example

var equal = require('deep-equal');
console.dir([
    equal(
        { a : [ 2, 3 ], b : [ 4 ] },
        { a : [ 2, 3 ], b : [ 4 ] }
    ),
    equal(
        { x : 5, y : [6] },
        { x : 5, y : 6 }
    )
]);

methods

var deepEqual = require('deep-equal')

deepEqual(a, b, opts)

Compare objects a and b, returning whether they are equal according to a recursive equality algorithm.

If opts.strict is true, use strict equality (===) to compare leaf nodes. The default is to use coercive equality (==) because that's how assert.deepEqual() works by default.

install

With npm do:

npm install deep-equal

test

With npm do:

npm test

Changelog

v2.0.2 - 2020-04-01

Commits

• [Fix] properly pass strict option through internals 4e2919d
• [Tests] add more coverage a3d8677
• [Tests] add coverage reporting 3174e33
• [Refactor] add strict pragma; remove unused try/catch c1d173e
• [Fix] the prototype property is not special on non-functions 1c3cc25
• [Deps] update es-abstract, es-get-iterator, is-date-object, is-regex, object-is, regexp.prototype.flags, side-channel 7787bdc
• [Deps] update es-abstract, es-get-iterator, which-collection 87624cf
• [Fix] robustly distinguish Typed Arrays 7ccb2b0
• [Dev Deps] update @ljharb/eslint-config, tape c1814a1
• [Dev Deps] update @ljharb/eslint-config, object.getownpropertydescriptors, tape 7a0d819
• [Dev Deps] update auto-changelog, tape f248756
• [Tests] fix tag helper, from bb50ea2e6d7906cd58683fdc7d327660e71612f4 469f008
• [Dev Deps] update eslint, tape 6537dce
• [Fix] make isBuffer check slightly more robust c21e14d
• [meta] disable greenkeeper updates for semver 724f051
• [Deps] update es-abstract 942ad86
• [Deps] update es-abstract 8724052