A utility that provides a stable identity of an object
This is free to use software, but if you do like it, consider supporting me ❤️
- ✅ Intuitive
- 🌪 Recursive/Circular support
- 🏎 Performant — check the benchmarks.
- 🪶 Lightweight — a mere 387B and no dependencies.
import { identify } from 'object-identity';
// or
import { identify } from 'https://deno.land/x/object_identity';
// ~> identity the object
const id1 = identify({ a: new Set(['b', 'c', new Map([['d', 'e']])]) });
// ~> an entirely different object, but structurally the same
const id2 = identify({ a: new Set(['b', 'c', new Map([['e', 'e']])]) });
// they should equal
assert.toEqual(hashA, hashB);
via the
/bench
directory with deno 1.45.2
✔ object-identity ~ 313,676 ops/sec ± 0.39%
✔ object-hash ~ 88,873 ops/sec ± 0.16%
✔ json-stable-stringify ~ 444,839 ops/sec ± 0.41%
✔ tiny-stable-stringify ~ 520,833 ops/sec ± 0.45%
^
object-identity
is not as feature-full it's alternatives, specifically aroundfunction
values and other node builtins. So take this benchmark with a grain of salt, as it's only testing "json-like" payloads.
MIT © Marais Rossouw