https://github.com/smelukov/nano-equal
Ultra fast and compact implementation of deep equal without any production dependencies.
https://github.com/smelukov/nano-equal
comparison deep-equals equality fast no-dependencies
Last synced: 6 months ago
JSON representation
Ultra fast and compact implementation of deep equal without any production dependencies.
- Host: GitHub
- URL: https://github.com/smelukov/nano-equal
- Owner: smelukov
- License: mit
- Created: 2016-03-10T14:19:57.000Z (over 10 years ago)
- Default Branch: master
- Last Pushed: 2017-11-16T11:59:01.000Z (over 8 years ago)
- Last Synced: 2025-06-10T22:52:38.137Z (about 1 year ago)
- Topics: comparison, deep-equals, equality, fast, no-dependencies
- Language: JavaScript
- Homepage:
- Size: 21.5 KB
- Stars: 19
- Watchers: 2
- Forks: 5
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE.md
Awesome Lists containing this project
README
[](https://travis-ci.org/smelukov/nano-equal)
[](https://badge.fury.io/js/nano-equal)
## NanoEqual
Ultra fast and compact implementation of deep equal without any production dependencies.
### Usage
```shell
npm install nano-equal --save
```
```javascript
var nanoEqual = require('nano-equal');
if (nanoEqual(a, b)) {
//....
}
```
### What is that?
This is a compact and fast implementation of deep equal.
Deep equal is an algorithm that comparing two values. If the values are a scalar (string, bool, number), then comparing will be performed thru === operator.
If the values are an object (object, array, function), then comparing will be performed recursively.
Following of the object properties is not important:
```javascript
var a = {prop1: 'some', prop2: 'some'};
var b = {prop2: 'some', prop1: 'some'};
nanoEqual(a, b); // true
```
But following of the array elements is important:
```javascript
var a = [1, 2, 3];
var b = [3, 2, 1];
nanoEqual(a, b); // false
```
> NaN values and some types of recursion are supported.
### Benchmark
The list below is showing the performance comparison nano-equal with other libs:
```
nanoEqual: 1362.813ms
underscore: 3791.308ms
lodash: 7830.107ms
nodejs: 8272.956ms
```