O que é um UUID?
UUID (Universally Unique Identifier), também chamado de GUID, é um identificador de 128 bits projetado para ser único sem precisar de um servidor central que coordene a numeração. Por isso é tão usado como chave primária em bancos de dados, ID de objetos em APIs, nomes de arquivos e rastreamento de eventos — dois sistemas podem gerar IDs ao mesmo tempo, offline, com chance praticamente nula de colisão.
O v4 é totalmente aleatório (122 bits de entropia) e é o padrão para a maioria dos casos. O v7 é mais novo: começa com um carimbo de tempo em milissegundos, então os IDs gerados ficam ordenados cronologicamente — ótimo para chaves de banco, porque melhora a localidade de índice (ao contrário do v4, que espalha as inserções). Aqui a geração usa crypto.getRandomValues, o gerador criptográfico do navegador.
Perguntas frequentes
UUID v4 ou v7, qual usar?
Para a maioria dos casos, v4. Se o UUID for chave primária de banco e você quiser inserções ordenadas (melhor desempenho de índice), prefira v7, que é ordenável por tempo.
Qual a chance de dois UUIDs serem iguais?
Desprezível. No v4 são 122 bits aleatórios — seria preciso gerar bilhões por segundo durante décadas para ter chance real de colisão.
É seguro/aleatório de verdade?
Sim. Usamos crypto.getRandomValues, o gerador de números aleatórios criptográfico do navegador, em vez de Math.random.
Os UUIDs são enviados para vocês?
Não. Tudo é gerado localmente no seu navegador. Nada trafega pela rede.