How do I create a GUID / UUID?

javascript

uuid

performance

best-practices

byAnton Shumikhin·Aug 6, 2024

To create a RFC 4122-compliant UUID in modern JavaScript environments, use the crypto.randomUUID():

const uuid = crypto.randomUUID();
console.log(uuid); // prints '123e4567-e89b-12d3-a456-426614174000'

For older environments or browsers lacking crypto.randomUUID(), utilize this simple UUID generation function which is compliant with standards:

function uuidv4() {
  // OMG, look, math and randomness had a baby and named it UUID!
  return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, c =>
    (c === 'x' ? Math.random() * 16 : Math.random() * 16 & 0x3 | 0x8).toString(16)
  );
}

const uuid = uuidv4();
console.log(uuid); // Voila! 'efb2f3f4-3045-4b6c-9870-7943bead87f2'

Both flavors give you a v4 UUID, hot and fresh out of the JS oven!

Understanding UUID uniqueness and security

Although UUIDs are widely acclaimed for their uniqueness across all time and space (humble, right?), it's critical to question the method used to generate them.

Secure contexts, such as HTTPS or localhost, are increasingly vital in modern Web APIs. Particularly for those handling randomness or cryptography, context ensures the expected behavior, shielded from prying eyes.

When crypto.randomUUID() can't play the game, count on uuid or other libraries. They'll present a fool-proof method like uuidv4(), which pivots on crypto.getRandomValues() rather than Math.random(), ensuring a robust source of randomness, unlike its math cousin.

Mastering UUID optimization

UUID generation might seem as thrilling as watching paint dry, but trust me, there's more to it. Optimizing the process - paint it red, add some glitter - can enhance performance and reduce the eye-rolls from your users.

String templates and hex strings are great ways to increase performance and readability.
Bitwise operations ensure your ID will be on the hexadecimal honor roll.
Modularizing the generation with a UUID.generate() method improves code reusability.
And always remember, in JavaScript, ES6 syntax not only makes you look cool but also helps avoid potential issues in your UUID gen.

Upgrading to timestamp-based UUIDs

While v4 UUIDs are well-loved for their randomness, sometimes you need the flamboyant uniqueness of a timestamp-based ID. Enter the world of UUID v1.

// Picking up the timestamp-based UUID (v1)
const { v1: uuidv1 } = require('uuid');
let timestampUUID = uuidv1();
console.log(timestampUUID); // '2c5ea4c0-4067-11e9-8bad-9b1deb4d3b7d'

With their fancy timestamp, sequence number, and machine identifier, v1 UUIDs add another layer to the uniqueness cake.

Validating your UUIDs

You’ve created a UUID, now show it some love! Check its uniqueness and ensure it adheres to standard formats by using online UUID validation tools. Always ensure that your UUID is as RFC 4122 compliant as it claims to be!

UUID in-action: Walking through real-world scenarios

Performance considerations across environments

When generating UUIDs, keep in mind that platform performance matters. Mobile devices may not be as snappy or random as desktops.

Realizing high-precision timing in UUIDs

Up your UUID game by adding high-performance timing data from performance.now(). It boosts randomness and individuality by trickling in extra time precision.

Adhering to formatting standards across systems

Every UUID should be a champion - a 32-character hexadecimal sequence formatted as xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx. This format includes version and variant indicators and is key to UUID conformity and recognition across platforms.

explain-codes / Javascript / How do I create a GUID / UUID?

Linked

Efficient method to generate UUID String in Java (UUID.randomUUID().toString() without the dashes)



Create a GUID / UUID in Java



How can I create unique IDs with JavaScript?



Secure random token in Node.js



Generate random number between two numbers in JavaScript

