# hyperdyperid

> Fastest random ID and random string generation for Node.js

Latest version **1.2.0** (published 2022-04-23) · MIT license · 0 weekly downloads

## Install

```sh
npm install hyperdyperid
pnpm add hyperdyperid
yarn add hyperdyperid
bun add hyperdyperid
```

## Health

**Score 25/100 (F)** — status: abandoned.

Positive: has types; no vulnerabilities; high quality score.

Warnings: low downloads; no esm support.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 1.2.0 |
| Published | 2022-04-23 |
| First published | 2020-10-12 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | CommonJS |
| Node | >=10.18 |
| Dependencies | 0 |
| Unpacked size | 840.4 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 12 |
| Author | streamich |
| Maintainers | streamich |

## Links

- npm: https://www.npmjs.com/package/hyperdyperid
- Repository: https://github.com/streamich/hyperdyperid
- Issues: https://github.com/streamich/hyperdyperid/issues
- npm.io page: https://npm.io/package/hyperdyperid

## Recent versions

- 1.2.0 (latest) — 2022-04-23
- 1.1.0 — 2022-04-23
- 1.0.1 — 2020-10-12
- 1.0.0 — 2020-10-12

## README

# `hyperdyperid`

Fastest random ID and random string generation for Node.js

- `str3_36` — generates random 3 character Base36 alphanumeric string.
- `str5_36` — generates random 5 character Base36 alphanumeric string.
- `str6_36` — generates random 6 character Base36 alphanumeric string.
- `str10_36` — generates random 10 character alphanumeric string.
- `str(len [, alphabet])` — generates any length random string using an `alphabet`. Use like `str(10, '0123456789')`.
- `hyperid` — generates "hyperid" like ID.
- `xorshift32` — iterates through pseudo random numbers using "xorshift32" algorithm. This used
  to be the algorithm behind `Math.random()` in V8, then it switched to "xorshift64".
- `randomU32(min, max)` — generate a random 32-bit integer.


## Usage

Install

```
yarn add hyperdyperid
```

Generate base36 10-character string:

```js
const {str10_36} = require('hyperdyperid/lib/str10_36');

str10_36();
// lxifpmidcr
// cn41vpmtxo
// dj2u5ghp3r
// 6yro5d0g9l
```


## Performance

Ran on Mac Mini M1.

Random ID generation:

```
node -v
v16.14.2
node benchmarks/main.js 
hyperdyperid xorshift32() x 241,258,490 ops/sec ±1.97% (78 runs sampled)
hyperdyperid str3_36() x 203,361,942 ops/sec ±1.57% (82 runs sampled)
hyperdyperid str5_36() x 124,134,559 ops/sec ±1.74% (85 runs sampled)
hyperdyperid str6_36() x 125,011,053 ops/sec ±2.48% (70 runs sampled)
hyperdyperid str10_36() x 19,445,199 ops/sec ±1.92% (84 runs sampled)
hyperdyperid str(5) x 5,940,801 ops/sec ±1.70% (82 runs sampled)
hyperdyperid str(10) x 2,798,758 ops/sec ±1.45% (65 runs sampled)
hyperdyperid hyperid() x 26,317,209 ops/sec ±2.61% (76 runs sampled)
hyperid x 17,018,022 ops/sec ±1.66% (84 runs sampled)
Math.random() x 72,294,752 ops/sec ±1.65% (83 runs sampled)
Math.random().toString() x 4,503,932 ops/sec ±2.68% (80 runs sampled)
nanoid x 470,470 ops/sec ±3.17% (77 runs sampled)
shortid x 41,870 ops/sec ±6.21% (67 runs sampled)
Fastest is hyperdyperid xorshift32()
```

Random integer generation:

```
node -v
v16.14.2
node benchmarks/randomU32.js 
randomU32(min, max) x 248,233,310 ops/sec ±1.91% (73 runs sampled)
Math.random() * (max - min + 1) + min x 35,034,863 ops/sec ±1.75% (81 runs sampled)
Fastest is randomU32(min, max)
```


## License

[MIT © Vadim Dalecky](LICENSE).

---
_Source: https://npm.io/package/hyperdyperid · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._