1.1.1 • Published 8 years ago

@segment/equals v1.1.1

Weekly downloads
106
License
MIT
Repository
github
Last release
8 years ago

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