npmpackage.info

nested-equal

🧬 A tiny (~239B) and fast nested/deep equality utility

1.0.1

MIT

TypeScript

335.00 B

5,218 3.2

Installations

npm install nested-equal

Developer Guide

BETA

Typescript

Yes

Module System

CommonJS, ESM, UMD

Node Version

12.16.3

NPM Version

6.14.4 Pull Requests

Open

5

Total

10

Closed

0

Merged

5

Issues

Open

0

Total

0

Closed

0

Releases

nested-equal@1.0.1

v1.0.1

Published on 16 Feb 2022

View all 1 releases

Contributors

Unable to fetch Contributors

View all 1 contributors

Languages

TypeScript

JavaScript

TypeScript (53.81%)

JavaScript (46.19%)

Love this project? Help keep it running — sponsor us today! 🚀

Developer

alizeait

Download Statistics

Total Downloads

5,218

Last Day

Last Week

Last Month

Last Year

2,090

GitHub Statistics

14 Commits

1 Watching

9 Branches

1 Contributors

Bundle Size

556.00 B

Minified

335.00 B

Minified + Gzipped

Bundlephobia

Maintainers

Package Meta Information

Latest Version

1.0.1

Package Id

nested-equal@1.0.1

Unpacked Size

14.36 kB

Size

4.04 kB

File Count

NPM Version

6.14.4

Node Version

12.16.3

Total Downloads

Cumulative downloads

Total Downloads

5,218

Last day

-16.7%

Compared to previous day

Last week

146.2%

Compared to previous week

Last month

2.3%

Compared to previous month

Last year

70.9%

2,090

Compared to previous year

Daily Downloads

Weekly Downloads

Monthly Downloads

Yearly Downloads

Dev Dependencies

@types/jest benchmark codecov lodash.isequal deep-equal fast-deep-equal nano-equal ts-jest typescript microbundle dequal jest

Versions

nested-equal

A tiny (~239B) and super fast deep/nested equality utility.

Takes 2 values and returns a boolean indicating if they are equal or not by traversing recursively. Supports Objects, Arrays, Numbers, Strings, null, undefined, NaN, Functions. Other types like Map, Set, Date and others use reference equality instead of value equality.

Key order within objects does not matter while value order within arrays does matter.

Installation

1$ npm install nested-equal

Usage

1import { nestedEqual } from "nested-equal";
2
3nestedEqual({},{}); // true
4nestedEqual({a:1},{a:1}); // true
5nestedEqual([1,2],[1,3]); // false 
6nestedEqual(NaN,NaN); // true 
7nestedEqual([1,2,3],[1,2,3]); // true 
8nestedEqual([
9  {a:'value',b:'value'},
10  {a:'value',b:'value'},
11],[
12  {a:'value',b:'value'},
13  {a:'value',b:'value'},
14]) // true
15nestedEqual(5,'5'); // false
16nestedEqual(null,null); // true 
17nestedEqual(null,undefined); // false

Benchmarks

Claiming a library is fast without looking into the data structure is naive at best, since the data structure largely impacts performance as no algorithm can handle all the different data structures. Hence a couple of benchmarks were made with some different data structures to compare it to other popular libararies.

Benchmark 1
  lodash.isequal               x 66,593 ops/sec ±0.43% (92 runs sampled)
  deep-equal                   x 772 ops/sec ±4.45% (43 runs sampled)
  nested-equal                 x 458,818 ops/sec ±0.40% (91 runs sampled)
  dequal                       x 431,045 ops/sec ±0.23% (95 runs sampled)
  nano-equal                   x 284,753 ops/sec ±0.37% (89 runs sampled)

Benchmark 2
  lodash.isequal               x 853,636 ops/sec ±0.67% (91 runs sampled)
  deep-equal                   x 2,172 ops/sec ±1.83% (75 runs sampled)
  nested-equal                 x 6,034,107 ops/sec ±0.72% (93 runs sampled)
  dequal                       x 5,302,918 ops/sec ±0.70% (95 runs sampled)
  nano-equal                   x 3,542,214 ops/sec ±0.24% (93 runs sampled)

Benchmark 3
  lodash.isequal               x 14,347,632 ops/sec ±0.89% (91 runs sampled)
  deep-equal                   x 4,502 ops/sec ±1.76% (72 runs sampled)
  nested-equal                 x 21,252,686 ops/sec ±0.31% (93 runs sampled)
  dequal                       x 21,489,939 ops/sec ±0.32% (94 runs sampled)
  nano-equal                   x 28,915,716 ops/sec ±0.49% (94 runs sampled)

Benchmark 4
  lodash.isequal               x 63,600 ops/sec ±1.16% (64 runs sampled)
  deep-equal                   x 1,420 ops/sec ±0.64% (88 runs sampled)
  nested-equal                 x 2,909,724 ops/sec ±0.22% (91 runs sampled)
  dequal                       x 4,138,053 ops/sec ±0.25% (94 runs sampled)
  nano-equal                   x 1,662,534 ops/sec ±2.92% (90 runs sampled)

Benchmark 5
  lodash.isequal               x 70,076 ops/sec ±0.93% (90 runs sampled)
  deep-equal                   x 2,113 ops/sec ±0.54% (88 runs sampled)
  nested-equal                 x 7,432,844 ops/sec ±0.22% (93 runs sampled)
  dequal                       x 7,161,662 ops/sec ±0.61% (94 runs sampled)
  nano-equal                   x 4,496,048 ops/sec ±0.59% (94 runs sampled)

Running on Node.js v12.13.0, 64-bit OS, Intel(R) Core(TM) i5-6600K CPU @ 3.50GHz, 16.0 GB RAM

API

nestedEqual(value1:any,value2:any)

Returns: Boolean

Returns true or false indicating if the two values are equal or not.

No vulnerabilities found.

10

Binary-Artifacts

Determines if the project has generated executable (binary) artifacts in the source repository.

10

Dangerous-Workflow

Determines if the project's GitHub Action workflows avoid dangerous patterns.

10

License

Determines if the project has defined a license.

7

SAST

Determines if the project uses static code analysis.

0

Maintained

Determines if the project is "actively maintained".

0

Code-Review

Determines if the project requires human code review before pull requests (aka merge requests) are merged.

0

Token-Permissions

Determines if the project's workflows follow the principle of least privilege.

0

Pinned-Dependencies

Determines if the project has declared and pinned the dependencies of its build process.

0

CII-Best-Practices

Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.

0

Security-Policy

Determines if the project has published a security policy.

0

Fuzzing

Determines if the project uses fuzzing.

0

Vulnerabilities

Determines if the project has open, known unfixed vulnerabilities.

Score

3.2

/10

Last Scanned on 2025-02-03

The Open Source Security Foundation is a cross-industry collaboration to improve the security of open source software (OSS). The Scorecard provides security health metrics for open source projects.

Learn More

Other packages similar to nested-equal

deep-equal-in-any-order

2.0.6

chai plugin to match objects and arrays deep equality with arrays (including nested ones) being in any order

object-all-values-equal-to

4.0.18

Does the AST/nested-plain-object/array/whatever contain only one kind of value?

deep-equal-nested-array

1.0.0

Deep Equal for nested JSON objects along with array

equal-checker

1.0.8

Lightweight function to check if two Objects, Arrays, or single Values are equal. Uses Recursion to check any combination and level of NESTING.