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 ] }
)
Different Structure:
equal(
{ x : 5, y : [6] },
{ x : 5}
)
Same structure, different values:
equal(
{ a: [ 1, 2 ], b : [ 4 ]},
{ a: [ 2, 3 ], b : [ 4 ]}
)
Primitives:
equal(new Date(0), new Date(1))
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