Uber-fast unique id generation, for Node.js and the browser. Here are the benchmarks:
hashids process.hrtime x 287,412 ops/sec ±0.99% (90 runs sampled)
hashids counter x 621,430 ops/sec ±0.29% (97 runs sampled)
shortid x 41,179 ops/sec ±0.42% (90 runs sampled)
crypto.random x 383,473 ops/sec ±1.32% (90 runs sampled)
nid x 1,451,918 ops/sec ±0.23% (96 runs sampled)
uuid.v4 x 381,392 ops/sec ±0.46% (90 runs sampled)
uuid.v1 x 1,904,561 ops/sec ±0.31% (96 runs sampled)
nanoid x 2,137,111 ops/sec ±0.31% (95 runs sampled)
hyperid - variable length x 15,252,339 ops/sec ±0.79% (88 runs sampled)
hyperid - fixed length x 15,029,819 ops/sec ±0.63% (93 runs sampled)
hyperid - fixed length, url safe x 15,449,475 ops/sec ±0.49% (93 runs sampled)
Note: Benchmark run with Intel(R) Core(TM) i7-7700 CPU @ 3.60GHz and Node.js v14.15.1
npm i hyperid --save
'use strict'
const hyperid = require('hyperid')
const instance = hyperid()
const id = instance()
console.log(id)
console.log(instance())
console.log(hyperid.decode(id))
console.log(hyperid.decode(instance()))
Returns a function to generate unique ids. The function can accept one of the following parameters:
fixedLength: Boolean
If fixedLength istrue
the function will always generate an id that is 33 characters in length, by defaultfixedLength
isfalse
.options: Object
If{ fixedLength: true }
is passed in, the function will always generate an id that is 33 characters in length, by defaultfixedLength
isfalse
. If{ urlSafe: true }
is passed in, the function will generate url safe ids. If{ startFrom: <int> }
is passed in, the first counter will start from that number, which must be between 0 and 2147483647. Fractions are discarded, only the integer part matters.
Returns an unique id.
The uuid used to generate the ids, it will change over time.
It is regenerated every Math.pow(2, 31) - 1
to keep the integer a SMI
(a V8 optimization).
Decode the unique id into its two components, a uuid
and a counter.
If you are generating url safe ids, you must pass { urlSafe: true }
as option.
It returns:
{
uuid: '049b7020-c787-41bf-a1d2-a97612c11418',
count: 1
}
This is aliased as instance.decode
.
MIT