59 lines
1.5 KiB
Markdown
59 lines
1.5 KiB
Markdown
|
# fast-deep-equal
|
||
|
|
The fastest deep equal
|
||
|
|
|
||
|
|
[](https://travis-ci.org/epoberezkin/fast-deep-equal)
|
||
|
|
[](http://badge.fury.io/js/fast-deep-equal)
|
||
|
|
[](https://coveralls.io/github/epoberezkin/fast-deep-equal?branch=master)
|
||
|
|
|
||
|
|
|
||
|
|
## Install
|
||
|
|
|
||
|
|
```bash
|
||
|
|
npm install fast-deep-equal
|
||
|
|
```
|
||
|
|
|
||
|
|
|
||
|
|
## Features
|
||
|
|
|
||
|
|
- ES5 compatible
|
||
|
|
- works in node.js (0.10+) and browsers (IE9+)
|
||
|
|
- checks equality of Date and RegExp objects by value.
|
||
|
|
|
||
|
|
|
||
|
|
## Usage
|
||
|
|
|
||
|
|
```javascript
|
||
|
|
var equal = require('fast-deep-equal');
|
||
|
|
console.log(equal({foo: 'bar'}, {foo: 'bar'})); // true
|
||
|
|
```
|
||
|
|
|
||
|
|
|
||
|
|
## Performance benchmark
|
||
|
|
|
||
|
|
Node.js v9.11.1:
|
||
|
|
|
||
|
|
```
|
||
|
|
fast-deep-equal x 226,960 ops/sec ±1.55% (86 runs sampled)
|
||
|
|
nano-equal x 218,210 ops/sec ±0.79% (89 runs sampled)
|
||
|
|
shallow-equal-fuzzy x 206,762 ops/sec ±0.84% (88 runs sampled)
|
||
|
|
underscore.isEqual x 128,668 ops/sec ±0.75% (91 runs sampled)
|
||
|
|
lodash.isEqual x 44,895 ops/sec ±0.67% (85 runs sampled)
|
||
|
|
deep-equal x 51,616 ops/sec ±0.96% (90 runs sampled)
|
||
|
|
deep-eql x 28,218 ops/sec ±0.42% (85 runs sampled)
|
||
|
|
assert.deepStrictEqual x 1,777 ops/sec ±1.05% (86 runs sampled)
|
||
|
|
ramda.equals x 13,466 ops/sec ±0.82% (86 runs sampled)
|
||
|
|
The fastest is fast-deep-equal
|
||
|
|
```
|
||
|
|
|
||
|
|
To run benchmark (requires node.js 6+):
|
||
|
|
|
||
|
|
```bash
|
||
|
|
npm install
|
||
|
|
node benchmark
|
||
|
|
```
|
||
|
|
|
||
|
|
|
||
|
|
## License
|
||
|
|
|
||
|
|
[MIT](https://github.com/epoberezkin/fast-deep-equal/blob/master/LICENSE)
|