object-code

  
⛓️
Object Code
  

Object Code is a blazing fast hash code generator that supports every possible javascript value.

Table of Contents

• Table of Contents
• Installing
  • Node
  • Browser
  • Url Import
• Getting Started
• Compatibility
• Benchmark
• License

Installing

Node

npm install object-code # or yarn add object-code

const { hash } = require('object-code');
import { hash } from 'object-code';

Browser

<script
  crossorigin
  src="https://cdn.jsdelivr.net/npm/object-code@latest/dist/index.umd.js"
></script>

const { hash } = window.objectCode;

Url Import

import { hash } from 'https://cdn.skypack.dev/object-code@latest';

Getting Started

Object code is a blazing fast hash code generator. It generates unique signed integers for objects, arrays, functions, symbols and etc.

You can ise it to index object in a collection, compare objects or just generate unique identifiers.

import { hash } from 'object-code';

const myWeirdObject = {
  name: 'Arthur',
  age: 20,
  address: {
    private: true
  },
  sayHello: function () {
    console.log('Hello!');
  },
  id: Symbol('arthur'),
  birth: new Date(2005, 02, 27),
  tags: ['person', 'male', 'programmer']
  // etc
};

const hash = hash(myWeirdObject);
// 1230491235

Compatibility

See all unique values at test/values.ts

This package is always seeking for a faster implementation. This means that we don't guarantee that the hash will be the same for two different versions of this package. There will be an warning on the release notes if the hash generation changed.

You shouldn't rely on cross version compatibility, and even if so, you can run some tests before pushing to production :)

Benchmark

This is the result of a benchmark between object-hash and object-code:

  Object Code:
    103 134 ops/s, ±2.64%     | 92.24% slower

  Object Hash:
    22 961 ops/s, ±0.26%      | slowest, 98.27% slower

  Object Code (Jsonified Object):
    268 170 ops/s, ±0.72%     | 79.82% slower

  Object Hash (Jsonified Object):
    116 239 ops/s, ±0.37%     | 91.25% slower

  Object Code (String):
    1 328 742 ops/s, ±0.47%   | fastest

  Object Hash (String):
    233 048 ops/s, ±0.47%     | 82.46% slower

License

Licensed under the MIT. See LICENSE for more informations.