Encodeur / Décodeur Base64 (UTF-8 et URL-safe)

Ce qu'est (et n'est pas) le Base64

Le Base64 encode des octets arbitraires en utilisant un alphabet de 64 caractères (A-Z, a-z, 0-9, +, /, avec le rembourrage =). C'est la méthode standard pour intégrer des données binaires — octets d'image, blobs chiffrés, jetons signés — dans des formats texte uniquement comme JSON, HTML ou les en-têtes d'e-mail. La sortie est environ 33 % plus grande que l'entrée.

Le Base64 est un encodage, pas un chiffrement. N'importe qui peut décoder une chaîne Base64 pour retrouver les octets d'origine. Ne l'utilise pas pour cacher des secrets — utilise un vrai algorithme de chiffrement si tu as besoin de confidentialité.

URL-safe vs standard

Le Base64 standard inclut '+' et '/', qui ont une signification spéciale dans les URLs et doivent être encodés en pourcentage. Le Base64 URL-safe (RFC 4648 §5) remplace '+' par '-', '/' par '_', et supprime le rembourrage '=' final. Les JWT, les jetons OAuth et de nombreuses API web utilisent la forme URL-safe.

Si tu décode un JWT ou un jeton manuellement, active l'option URL-safe. Si tu travailles avec des e-mails classiques ou des données intégrées dans des PDF, laisse-la désactivée. Le décodeur accepte les deux formes lorsque URL-safe est activé, car l'alphabet standard est un sur-ensemble sans la paire spéciale.

Gestion de l'UTF-8

L'ancienne fonction btoa() des navigateurs ne gère que l'ASCII. Cet outil utilise TextEncoder pour convertir d'abord ton entrée en octets UTF-8, puis encode ces octets en Base64. Cela signifie que les emojis, les caractères CJK, les lettres latines accentuées et tout autre caractère Unicode s'encodent et se décodent correctement. L'approche octets-puis-Base64 est la même que celle utilisée par les bibliothèques JWT et la plupart des frameworks modernes.