UUID v4 Generator

UUID v4 — найпоширеніша версія UUID у сучасному програмному забезпеченні. На відміну від своїх аналогів, що беруть біти з часової мітки або хешу простору імен, UUID v4 побудований повністю на випадкових даних — що робить його найпростішим і найуніверсальнішим вибором, коли потрібен унікальний ідентифікатор без будь-яких метаданих про його походження.

Цей генератор використовує crypto.randomUUID() — нативний API браузера та Node.js, що отримує ентропію з криптографічно захищеного генератора випадкових чисел операційної системи — того самого джерела, що використовується для ключового матеріалу TLS.

Що таке UUID v4?

Universally Unique Identifier (UUID) — це 128-бітна мітка, стандартизована в RFC 4122. Зазвичай представляється як 32 шістнадцяткові цифри, згруповані дефісами за шаблоном 8-4-4-4-12:

В UUID v4 122 із 128 бітів є випадковими. Решта 6 бітів — фіксовані поля, передбачені специфікацією: 4 біти кодують версію (0100 = 4) і 2 біти кодують варіант RFC 4122 (10). Саме тому третя група завжди починається з 4, а четверта — з 8, 9, a або b.

Анатомія UUID v4

Розбір 550e8400-e29b-41d4-a716-446655440000:

UUID v4 та інші версії

RFC 4122 визначає п'ять версій UUID. Кожна вирішує свою задачу:

Коли використовувати UUID v4

UUID v4 — правильний інструмент у переважній більшості ситуацій, коли потрібен просто «унікальний ID» без додаткових обмежень:

Ймовірність колізії

При 122 випадкових бітах простір UUID v4 містить 2¹²² ≈ 5,3 × 10³⁶ можливих значень. Ймовірність колізії відповідає задачі про парадокс днів народження:

Широко відомий орієнтир: щоб отримати 50% ймовірність однієї колізії, потрібно згенерувати приблизно 2,71 × 10¹⁸ UUID. При швидкості 1 мільярд UUID на секунду це займе приблизно 85 років безперервної генерації.

Приклади коду

JavaScript — Браузер і Node.js 14.17+

Метод crypto.randomUUID() доступний нативно у всіх сучасних браузерах і Node.js 14.17+. Встановлення пакетів не потрібне.

// Browser or Node.js 14.17+
const id = crypto.randomUUID()
// → "110e8400-e29b-41d4-a716-446655440000"

// Generate multiple
const ids = Array.from({ length: 5 }, () => crypto.randomUUID())

Node.js — старіші версії (пакет uuid)

const { v4: uuidv4 } = require('uuid')

const id = uuidv4()
// → "110e8400-e29b-41d4-a716-446655440000"

Python

import uuid

# Generate a UUID v4
id = str(uuid.uuid4())
# → '110e8400-e29b-41d4-a716-446655440000'

# The uuid module uses os.urandom() — cryptographically secure
print(uuid.uuid4().hex)  # without hyphens
# → '110e8400e29b41d4a716446655440000'

Go

import "github.com/google/uuid"

id := uuid.New().String()
// → "110e8400-e29b-41d4-a716-446655440000"

// Or using the standard library (Go 1.20+ with math/rand/v2 is NOT cryptographic)
// Always prefer github.com/google/uuid for production use

Rust

# Cargo.toml
[dependencies]
uuid = { version = "1", features = ["v4"] }

use uuid::Uuid;

let id = Uuid::new_v4().to_string();
// → "110e8400-e29b-41d4-a716-446655440000"

Часті запитання

const id = crypto.randomUUID()              // "550e8400-e29b-41d4-a716-446655440000"
const compact = id.replaceAll('-', '')     // "550e8400e29b41d4a716446655440000"