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: about 2 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 (almost 9 years ago)
• Default Branch: master
• Last Pushed: 2017-11-16T11:59:01.000Z (about 7 years ago)
• Last Synced: 2024-10-13T11:12:50.383Z (2 months 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

        
[![Build Status](https://travis-ci.org/smelukov/nano-equal.svg?branch=master)](https://travis-ci.org/smelukov/nano-equal)

[![npm version](https://badge.fury.io/js/nano-equal.svg)](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

```