equals

Check if two values are deeply equivalent

Usage no npm install needed!

<script type="module">
  import equals from 'https://cdn.skypack.dev/equals';
</script>

README

equals

compare values of any type for equility

Installation

With your favorite package manager:

  • packin: packin add equals
  • component: component install jkroso/equals
  • npm: npm install equals

then in your app:

var equal = require('equals')

API

equal(a, b, [memos])

equal takes as many arguments as you like of any type you like and returns a boolean result. Primitive types are equal if they are ===. While composite types, i.e. Objects and Arrays, are considered equal if they have both the same structure and each sub-value is also equal. Circular references in composite structures are supported.

Same structure:

equal(
  { a : [ 2, 3 ], b : [ 4 ] },
  { a : [ 2, 3 ], b : [ 4 ] }
) // => true

Different Structure:

equal(
  { x : 5, y : [6] },
  { x : 5}
) // => false

Same structure, different values:

equal(
  { a: [ 1, 2 ], b : [ 4 ]},
  { a: [ 2, 3 ], b : [ 4 ]}
) // => false

Primitives:

equal(new Date(0), new Date(1)) // => false

Some possible gotchas:

  • null is not equal to undefined.
  • NaN is equal to NaN (normally not the case).
  • -0 is equal to +0.
  • Strings will not coerce to numbers.
  • Non enumerable properties will not be checked. They can't be.
  • arguments.callee is not considered when comparing arguments