# `object-identity`

`npm add object-identity` hashes objects downloads size size

## ⚡ Features - ✅ **Intuitive** - 🌪 **Recursive/Circular support** - 🏎 **Performant** — check the [benchmarks](#-benchmark). - 🪶 **Lightweight** — a mere 387B and no [dependencies](https://npm.anvaka.com/#/view/2d/object-identity/). ## 🚀 Usage ```ts import { createHash } from 'node:crypto'; import { identify } from 'object-identity'; // ~> Some user defined hasher const hasher = (value) => createHash('sha1').update(value).digest('hex'); // ~> identity the object const hashA = identify({ a: new Set(['b', 'c', new Map([['d', 'e']])]) }, hasher); // ~> an entirely different object, but structurally the same const hashB = identify({ a: new Set(['b', 'c', new Map([['e', 'e']])]) }, hasher); // they should equal assert.toEqual(hashA, hashB); ``` ## 💨 Benchmark > via the [`/bench`](/bench) directory with Node v16.20.0 (Apple M1 Pro) ``` benchmark :: hashed object-hash x 60,632 ops/sec ±0.25% (98 runs sampled) object-identity x 569,618 ops/sec ±0.16% (100 runs sampled) benchmark :: passed through object-hash x 120,081 ops/sec ±0.18% (100 runs sampled) object-identity x 1,111,031 ops/sec ±0.09% (101 runs sampled) ``` > ^ `object-identity` is not as feature-full it's alternatives, specifically around `function` values and other node > builtins. So take this benchmark with a grain of salt, as it's only testing "json-like" payloads. ## License MIT © [Marais Rossouw](https://marais.io)