is-equal

is-equal

Are these two values conceptually equal?

Example

var isEqual = require('is-equal');
var assert = require('assert');

var primitives = [true, false, undefined, 42, 'foo'];
primitives.forEach(function (primitive) {
	assert.equal(isEqual(primitive, primitive), true);
});
assert.equal(isEqual(/a/g, /a/g), true);
assert.equal(isEqual(/a/g, new RegExp('a', 'g')), true);
assert.equal(isEqual({ a: 2 }, { a: 2 }), true);
assert.equal(isEqual([1, [2, 3], 4], [1, [2, 3], 4]), true);
var timestamp = Date.now();
assert.equal(isEqual(new Date(timestamp), new Date(timestamp)), true);

Want to know why two values are not equal?

Will return an empty string if isEqual would return true - otherwise will return a non-empty string that hopefully explains the reasoning.

var whyNotEqual = require('is-equal/why');

assert.equal(whyNotEqual(1, 1), '');
assert.equal(
  whyNotEqual({ a: 1 }, { a: 2 }),
  'value at key "a" differs: numbers are different: 1 !== 2'
);

Tests

Simply clone the repo, npm install, and run npm test

Changelog

v1.6.3 - 2021-08-06

Commits

• [Refactor] increase coverage; remove redundant branches c6b6672
• [Deps] update is-bigint, is-boolean-object, is-callable, is-date-object, is-generator-function, is-number-object, is-regex, is-string, is-symbol, object-inspect, object.entries a3b5498
• [Tests] tape v5.3 exposed a bug in corejs tests; use --require instead a1e004e
• [Refactor] use has-symbols/shams and has-bigints to more robustly detect these things 4f3aee4
• [Dev Deps] update auto-changelog, core-js, eslint, tape d6a7b8e
• [readme] fix usage code sample 04ce4d0