tiny-is-equal

Tiny & Fast is-equal check with various ES6 objects.

• No dependencies.
• Tiny bundle size. (NPM Minified: 1.3kB, Gzipped: 574B)
• Support for both CJS and ESM.
• Typescript based code, support type declarations.
• Comprehensive test coverage.

TODO

• Support for WeakSet & WeakMap.

Install

• Requirements: Node>=16.19.0

1$ yarn add tiny-is-equal # yarn
2$ npm install tiny-is-equal --save # npm
3$ pnpm install tiny-is-equal # pnpm

Usage

1// esm
2import isEqual from 'tiny-is-equal';
3
4isEqual({ a: 1, b: { c: 1 } }, { a: 1, b: { c: 1 } }) // true
5
6// cjs
7const isEqual = require('tiny-is-equal');
8
9isEqual({ a: 1, b: { c: 1 } }, { a: 1, b: { c: 1 } }) // true

tiny-is-equal supports various objects with ES6.

+0 & -0

1isEqual(+0, -0) // true

Set & Map

1const set1 = new Set([1, 2, 3]);
2const set2 = new Set([1, 2, 3]);
3
4isEqual(set1, set2) // true
5
6const map1 = new Map();
7const map2 = new Map();
8
9map1.set('a', 1);
10map2.set('a', 1);
11
12isEqual(map1, map2) // true

RegExp

1const regex1 = /(?:foo)/g;
2const regex2 = /(?:foo)/g;
3
4expect(isEqual(regex1, regex2)) // true

ArrayBuffer

1const buffer1 = new Uint8Array([1, 2, 3]);
2const buffer2 = new Uint8Array([1, 2, 3]);
3
4expect(isEqual(buffer1, buffer2)) // true

Error

1const err1 = new Error('error!');
2const err2 = new Error('error!');
3
4expect(isEqual(err1, err2)) // true

BenchMarks

Environment

1clk: ~1.88 GHz
2cpu: Apple M2
3runtime: node 23.2.0 (arm64-darwin)

Benchmark for simple use case

1$ pnpm run benchmark:simple
2
3+ tiny-is-equal x 1,123,456 ops/sec ±0.25% (98 runs sampled)
4dequal x 774,522 ops/sec ±0.21% (98 runs sampled)
5fast-deep-equal x 600,823 ops/sec ±1.01% (92 runs sampled)
6underscore.isEqual x 255,012 ops/sec ±0.35% (97 runs sampled)
7es-toolkit.isEqual x 217,138 ops/sec ±0.09% (94 runs sampled)
8lodash.isEqual x 107,261 ops/sec ±0.24% (98 runs sampled)
9deep-equal x 508 ops/sec ±2.77% (73 runs sampled)

Benchmark for complex use case

1$ pnpm run benchmark:complex
2
3+ tiny-is-equal x 139,032 ops/sec ±0.15% (97 runs sampled)
4dequal x 164,526 ops/sec ±0.89% (98 runs sampled)
5fast-deep-equal x 55,848 ops/sec ±4.45% (92 runs sampled)
6underscore.isEqual x 85,663 ops/sec ±0.72% (95 runs sampled)
7lodash.isEqual x 4,708 ops/sec ±3.68% (96 runs sampled)
8es-toolkit.isEqual x 30,110 ops/sec ±0.29% (101 runs sampled)
9deep-equal x 419 ops/sec ±1.72% (80 runs sampled)

You can see the detailed benchmark results in benchmark.

Test

1$ pnpm run test

License

MIT