Skip to content

crypto: implement randomUUIDv7() #62553

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
nodejs-github-bot merged 7 commits into from
Apr 5, 2026
+185 −5
Merged

crypto: implement randomUUIDv7() #62553

Changes from 1 commit
Commits
Show all changes
7 commits
Select commit Hold shift + click to select a range
628715c
crypto: implement randomUUIDv7()
nabeel378 Apr 2, 2026
274b11a
crypto: refactor randomUUIDv7() to use serializeUUID for improved rea…
nabeel378 Apr 2, 2026
87dd2ac
test: remove redundant checks for UUID version and variant bits
nabeel378 Apr 2, 2026
828867d
crypto: update randomUUIDv7() to construct UUID string directly from …
nabeel378 Apr 2, 2026
e3a4a06
crypto: update randomUUIDv7() to accept options for disabling entropy…
nabeel378 Apr 2, 2026
8ddc406
crypto: address review feedback for randomUUIDv7
nabeel378 Apr 2, 2026
49dac43
docs: update RFC 9562 link in crypto documentation
nabeel378 Apr 2, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Prev Previous commit
Next Next commit
test: remove redundant checks for UUID version and variant bits
  • Loading branch information
@nabeel378
nabeel378 committed Apr 2, 2026
commit 87dd2ac0d3f88e1c7cb31f14673d2b67535a74cd
7 changes: 0 additions & 7 deletions test/parallel/test-crypto-randomuuidv7.js
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,6 @@ const {
randomUUIDv7,
} = require('crypto');

// Basic return type and format checks.
{
const uuid = randomUUIDv7();
assert.strictEqual(typeof uuid, 'string');
Expand All @@ -23,22 +22,18 @@ const {
);
}

// Check version and variant bits.
{
const uuid = randomUUIDv7();

// Version 7: byte 6 high nibble should be 0x7.
assert.strictEqual(
Buffer.from(uuid.slice(14, 16), 'hex')[0] & 0xf0, 0x70,
);

// Variant: byte 8 high 2 bits should be 0b10.
assert.strictEqual(
Buffer.from(uuid.slice(19, 21), 'hex')[0] & 0b1100_0000, 0b1000_0000,
);
}

// Uniqueness: generate many UUIDs and verify no duplicates.
{
const seen = new Set();
for (let i = 0; i < 1000; i++) {
Expand All @@ -64,8 +59,6 @@ const {
assert(timestamp <= after, `Timestamp ${timestamp} > after ${after}`);
}

// Monotonicity: UUIDs generated in sequence should sort lexicographically
// within the same millisecond or across milliseconds.
{
let prev = randomUUIDv7();
for (let i = 0; i < 100; i++) {
Expand Down