Générer et manipuler des GUID en TypeScript

GUID est le terme couramment utilisé dans l’écosystème Microsoft pour un identifiant global unique de 128 bits. Sa forme textuelle canonique est compatible avec le format UUID, même si certaines plateformes proposent des formats GUID supplémentaires.

Démarrage rapide#

L’exemple suivant utilise l’API standard de TypeScript ou une bibliothèque couramment utilisée pour cette tâche.

Exemple#

1const id: string = crypto.randomUUID();2console.log(id);

Opérations courantes#

Ce second exemple couvre une opération fréquente en production ou une manière plus sûre de traiter des entrées réelles.

Variante courante#

1type Guid = string & { readonly __guid: unique symbol };2const GUID_RE = /^[--f]{}-[--f]{}-[-][--f]{}-[][--f]{}-[--f]{}$/i;34function asGuid(value: string): Guid {5  if (!GUID_RE.test(value)) throw new TypeError("Invalid GUID");6  return value as Guid;7}89const id = asGuid(crypto.randomUUID());

Points importants#

Validez les identifiants reçus de l’extérieur et utilisez la forme canonique avec tirets pour l’interopérabilité entre plateformes.

Bonnes pratiques#

1. Considérez toute entrée externe comme non fiable et gérez explicitement les erreurs d’analyse ou de validation.
2. Rendez explicites l’encodage, les unités, les formats et les conventions propres aux bibliothèques aux frontières du système.
3. Ajoutez des tests couvrant l’entrée vide, le texte Unicode, les entrées invalides et des données représentatives de la production.

Références#

• RFC 9562: UUIDs
• TypeScript Handbook