# `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 hash = (value) => { const id = identify(value); return createHash("sha1").update(id).digest("hex"); }; // ~> identity the object const hashA = hash({ a: new Set(["b", "c", new Map([["d", "e"]])]) }); // ~> an entirely different object, but structurally the same const hashB = hash({ a: new Set(["b", "c", new Map([["e", "e"]])]) }); // 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 58,395 ops/sec ±0.23% (96 runs sampled) object-identity x 1,180,665 ops/sec ±0.44% (96 runs sampled) benchmark :: passed through object-hash x 123,699 ops/sec ±0.22% (99 runs sampled) object-identity x 1,188,861 ops/sec ±0.21% (99 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)