You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

58 lines
1.5 KiB

4 years ago
  1. # fast-deep-equal
  2. The fastest deep equal
  3. [![Build Status](https://travis-ci.org/epoberezkin/fast-deep-equal.svg?branch=master)](https://travis-ci.org/epoberezkin/fast-deep-equal)
  4. [![npm version](https://badge.fury.io/js/fast-deep-equal.svg)](http://badge.fury.io/js/fast-deep-equal)
  5. [![Coverage Status](https://coveralls.io/repos/github/epoberezkin/fast-deep-equal/badge.svg?branch=master)](https://coveralls.io/github/epoberezkin/fast-deep-equal?branch=master)
  6. ## Install
  7. ```bash
  8. npm install fast-deep-equal
  9. ```
  10. ## Features
  11. - ES5 compatible
  12. - works in node.js (0.10+) and browsers (IE9+)
  13. - checks equality of Date and RegExp objects by value.
  14. ## Usage
  15. ```javascript
  16. var equal = require('fast-deep-equal');
  17. console.log(equal({foo: 'bar'}, {foo: 'bar'})); // true
  18. ```
  19. ## Performance benchmark
  20. Node.js v9.11.1:
  21. ```
  22. fast-deep-equal x 226,960 ops/sec ±1.55% (86 runs sampled)
  23. nano-equal x 218,210 ops/sec ±0.79% (89 runs sampled)
  24. shallow-equal-fuzzy x 206,762 ops/sec ±0.84% (88 runs sampled)
  25. underscore.isEqual x 128,668 ops/sec ±0.75% (91 runs sampled)
  26. lodash.isEqual x 44,895 ops/sec ±0.67% (85 runs sampled)
  27. deep-equal x 51,616 ops/sec ±0.96% (90 runs sampled)
  28. deep-eql x 28,218 ops/sec ±0.42% (85 runs sampled)
  29. assert.deepStrictEqual x 1,777 ops/sec ±1.05% (86 runs sampled)
  30. ramda.equals x 13,466 ops/sec ±0.82% (86 runs sampled)
  31. The fastest is fast-deep-equal
  32. ```
  33. To run benchmark (requires node.js 6+):
  34. ```bash
  35. npm install
  36. node benchmark
  37. ```
  38. ## License
  39. [MIT](https://github.com/epoberezkin/fast-deep-equal/blob/master/LICENSE)