# nano-equal

> Ultra fast and compact implementation of deep equal without any production dependencies.

Latest version **2.0.2** (published 2017-11-16) · MIT license · 0 weekly downloads

## Install

```sh
npm install nano-equal
pnpm add nano-equal
yarn add nano-equal
bun add nano-equal
```

## Health

**Score 23/100 (F)** — status: abandoned.

Positive: has types package; no vulnerabilities; high quality score.

Warnings: low downloads; no esm support.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 2.0.2 |
| Published | 2017-11-16 |
| First published | 2016-03-10 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | separate (@types/nano-equal) |
| Module format | CommonJS |
| Dependencies | 0 |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 19 |
| Author | Sergey Melyukov |
| Maintainers | smelukov |
| Keywords | equal, deep equal |

## Links

- npm: https://www.npmjs.com/package/nano-equal
- Repository: https://github.com/smelukov/nano-equal
- Homepage: https://github.com/smelukov/nano-equal#readme
- Issues: https://github.com/smelukov/nano-equal/issues
- npm.io page: https://npm.io/package/nano-equal

## Recent versions

- 2.0.2 (latest) — 2017-11-16
- 2.0.1 — 2017-08-23
- 2.0.0 — 2017-08-23
- 1.0.1 — 2016-03-10
- 1.0.0 — 2016-03-10

## 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
```

---
_Source: https://npm.io/package/nano-equal · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._