NanoID Üretici

NanoID Nedir?

NanoID, küçük, hızlı, URL güvenli rastgele bir ID oluşturucudur. Varsayılan olarak 64 karakterlik bir alfabe (A-Za-z0-9_-) kullanarak 21 karakterlik dizeler üretir ve yaklaşık 126 bit entropi sağlar — UUID v4'ün 122 bitiyle karşılaştırılabilir ama daha kısa bir dizede.

NanoID bir zaman damgası veya yapısal veri gömmez. Her ID, işletim sisteminin kriptografik açıdan güvenli rastgele sayı oluşturucusundan üretilen tamamen rastgeledir.

NanoID ile UUID v4 Karşılaştırması

NanoID ve UUID v4, her ikisi de CSPRNG destekli rastgele ID oluşturuculardır. Biçim, uzunluk ve ekosistem desteği açısından farklıdırlar:

Dış sistemlerle birlikte çalışabilirlik önemliyse UUID v4'ü seçin. Daha kısa ID'ler istiyorsanız ve tam yığını kontrol ediyorsanız NanoID'yi seçin.

Boyuta Göre Çakışma Olasılığı

NanoID'nin çakışma olasılığı ID uzunluğuna ve oluşturma hızına bağlıdır. Aşağıdaki tablo varsayılan 64 karakterlik alfabeyi kullanır:

Varsayılan 21 karakterlik boyut, UUID v4'ün çakışma direnciyle (~126 bit) eşleşecek ancak yüzde 41 daha kısa olacak şekilde seçilmiştir.

Özel Alfabeler

NanoID'nin alfabesi tamamen özelleştirilebilir. Kitaplık, alfabe olarak herhangi bir benzersiz karakter dizesini kabul eder:

Önemli: nanoid/non-secure'u yalnızca güvenlik açısından hassas olmayan uygulamalar için kullanın. Tahmin edilemez olması gereken her ID için her zaman varsayılan güvenli içe aktarmayı kullanın.

NanoID Rastgeleliği Nasıl Üretir

NanoID, işletim sisteminin kriptografik açıdan güvenli sözde rastgele sayı üreticisini (CSPRNG) kullanır. Tarayıcılarda bu crypto.getRandomValues()'tır; Node.js'de crypto.randomFillSync()'tir.

Reddedilme Örneklemesi (Modülo Sapmasından Kaçınma)

Rastgele karakterler üretmeye yönelik saf yaklaşım: rastgele bir bayt (0–255) alın ve byte % alphabetSize hesaplayın. Bu, bazı karakterlerin diğerlerinden biraz daha sık görünmesine yol açan modülo sapması oluşturur.

NanoID, reddedilme örneklemesi kullanarak bu sapmayı giderir:

1. Alfabe boyutunu kapsayan en küçük iki kuvvetli maskeyi belirleyin (ör. 64 karakterli alfabe için maske 63 = 0b00111111'dir)
2. Rastgele baytlar oluşturun ve maskeyi uygulayın: byte & mask
3. Maskelenmiş değer alfabe aralığındaysa kullanın. Aksi takdirde atın ve tekrar deneyin.

Bu, bazı rastgele baytların atıldığı anlamına gelir, ancak sonuç alfabe üzerinde mükemmel düzgün bir dağılımdır.

// Pure browser — no npm package needed
function generateNanoid(alphabet, size) {
  const mask = (2 << (31 - Math.clz32((alphabet.length - 1) | 1))) - 1
  const step = Math.ceil((1.6 * mask * size) / alphabet.length)
  let id = ''
  while (id.length < size) {
    const bytes = crypto.getRandomValues(new Uint8Array(step))
    for (const byte of bytes) {
      const idx = byte & mask
      if (idx < alphabet.length) {
        id += alphabet[idx]
        if (id.length === size) break
      }
    }
  }
  return id
}

const URL_SAFE = 'useandom-26T198340PX75pxJACKVERYMINDBUSHWOLF_GQZbfghjklqvwyzrict'
generateNanoid(URL_SAFE, 21)  // → "V1StGXR8_Z5jdHi6B-myT"

Ortam Desteği

Kod Örnekleri

JavaScript / TypeScript

// npm i nanoid
import { nanoid } from 'nanoid'
nanoid()          // → "V1StGXR8_Z5jdHi6B-myT" (21 chars, URL-safe)
nanoid(8)         // → "Uakgb_J5" (custom size)

// Custom alphabet
import { customAlphabet } from 'nanoid'
const hexId  = customAlphabet('0123456789abcdef', 16)
hexId()       // → "4f3a1b8c9d2e0f7a"

const numId  = customAlphabet('0123456789', 8)
numId()       // → "30812894"

Tarayıcı (CDN)

NanoID, bir CDN içe aktarması aracılığıyla doğrudan tarayıcıda kullanılabilir.

// Pure browser — no npm package needed
function generateNanoid(alphabet, size) {
  const mask = (2 << (31 - Math.clz32((alphabet.length - 1) | 1))) - 1
  const step = Math.ceil((1.6 * mask * size) / alphabet.length)
  let id = ''
  while (id.length < size) {
    const bytes = crypto.getRandomValues(new Uint8Array(step))
    for (const byte of bytes) {
      const idx = byte & mask
      if (idx < alphabet.length) {
        id += alphabet[idx]
        if (id.length === size) break
      }
    }
  }
  return id
}

const URL_SAFE = 'useandom-26T198340PX75pxJACKVERYMINDBUSHWOLF_GQZbfghjklqvwyzrict'
generateNanoid(URL_SAFE, 21)  // → "V1StGXR8_Z5jdHi6B-myT"

Python

# pip install nanoid
from nanoid import generate

generate()              # → "V1StGXR8_Z5jdHi6B-myT"
generate(size=8)        # → "Uakgb_J5"
generate('0123456789abcdef', 16)  # custom alphabet + size

Node.js (CommonJS)

// Node.js — stdlib only, no npm needed
const { randomFillSync } = require('crypto')

function nanoid(alphabet, size) {
  const mask = (2 << (31 - Math.clz32((alphabet.length - 1) | 1))) - 1
  const step = Math.ceil((1.6 * mask * size) / alphabet.length)
  let id = ''
  while (id.length < size) {
    const bytes = randomFillSync(Buffer.alloc(step))
    for (const byte of bytes) {
      const idx = byte & mask
      if (idx < alphabet.length) { id += alphabet[idx]; if (id.length === size) break }
    }
  }
  return id
}

Sıkça Sorulan Sorular