Check if two values are deeply equivalent
JavaScript HTML Makefile
Latest commit e645a08 May 26, 2016 @jkroso rm component.json
I don't think it worked anyway
Permalink
Failed to load latest commit information.
test
.gitignore mass refactor Mar 31, 2013
License mass refactor Mar 31, 2013
Makefile es2015 May 22, 2016
Readme.md docs Oct 29, 2014
index.js es2015 May 22, 2016
package.json es2015 May 22, 2016

Readme.md

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