@napi-rs/uuid

!CI

Fastest _RFC4122_ generator for Node.js. Only v4 available for now.

> 🚀 Help me to become a full-time open-source developer by sponsoring me on Github

Install

``bash
yarn add @napi-rs/uuid
npm install @napi-rs/uuid
pnpm install @napi-rs/uuid
`

Performance

`
Running "UID string" suite...
Progress: 100%

crypto.randomUUID:
810 767 ops/s, ±0.50% | slowest, 92.69% slower

napi-uuid-v4:
11 084 015 ops/s, ±0.43% | fastest

@lukeed/uuid:
7 506 916 ops/s, ±0.69% | 32.27% slower

nanoid:
5 736 698 ops/s, ±0.54% | 48.24% slower

uuid-js:
1 855 307 ops/s, ±0.30% | 83.26% slower

Finished 5 cases!
Fastest: napi-uuid-v4
Slowest: crypto.randomUUID
`

$3

`
OS: Ubuntu 20.04.3 LTS on Windows 10 x86_64
Host: Micro-Star International Co., Ltd. MS-7C35
Kernel: 5.10.60.1-microsoft-standard-WSL2
Terminal: Windows Terminal
CPU: AMD Ryzen 9 5950X (32) @ 3.400GHz
Memory: 23839MiB / 32688MiB
`

API

`ts
import { v4 } from "@napi-rs/uuid";

console.log(v4()); // eb4ffe32-2232-422a-933f-b905c0dfea84
``

Support matrix

| | node12 | node14 | node16 |
| --------------------- | ------ | ------ | ------ |
| Windows x64 | ✓ | ✓ | ✓ |
| Windows arm64 | ✓ | ✓ | ✓ |
| macOS x64 | ✓ | ✓ | ✓ |
| macOS arm64 (m chips) | ✓ | ✓ | ✓ |
| Linux x64 gnu | ✓ | ✓ | ✓ |
| Linux x64 musl | ✓ | ✓ | ✓ |
| Linux arm gnu | ✓ | ✓ | ✓ |
| Linux arm64 gnu | ✓ | ✓ | ✓ |
| Linux arm64 musl | ✓ | ✓ | ✓ |
| Android arm64 | ✓ | ✓ | ✓ |
| Android armv7 | ✓ | ✓ | ✓ |
| FreeBSD x64 | ✓ | ✓ | ✓ |