Décodage Base64

Recommandations connexes

Qu'est-ce que le décodage Base64 ?

Cas d'utilisation

• Décoder une réponse d'API contenant un champ Base64 pour lire son contenu original
• Restaurer des données Base64 présentes dans des logs applicatifs ou système
• Lire une valeur encodée en Base64 dans un fichier de configuration (YAML, JSON, .env)
• Diagnostiquer une erreur de décodage Base64 (padding manquant, caractères invalides, mauvais jeu)
• Décoder le header ou le payload d'un JWT en mode URL-Safe pour inspecter les claims
• Récupérer le contenu lisible d'un token OAuth ou d'un en-tête HTTP Authorization Basic
• Convertir un texte MIME Base64 multi-lignes (pièce jointe e-mail) en contenu exploitable

Comment utiliser

1. Collez la chaîne Base64 à décoder dans la zone de saisie
2. Sélectionnez le jeu de caractères (UTF-8, ASCII ou ISO-8859-1) et la variante (Standard, URL-Safe, MIME)
3. L'outil décode automatiquement la chaîne et affiche le texte en clair
4. Copiez le résultat décodé ou téléchargez-le en .txt pour vos notes ou votre débogage

Fonctionnalités

• Conversion bidirectionnelle instantanée : décodage en temps réel avec debounce de 300 ms, sans clic manuel
• Trois jeux de caractères : UTF-8, ASCII, ISO-8859-1 pour couvrir le français, l'anglais et les données multilingues
• Compatibilité URL-safe et MIME : prise en charge automatique des variantes Base64URL (- _) et MIME (RFC 2045)
• Détection des caractères invalides : affichage de la position exacte de l'erreur pour corriger rapidement la chaîne
• Copie et téléchargement en un clic : copie du résultat dans le presse-papiers ou export en fichier .txt
• Trois variantes d'entrée : Standard, URL-Safe et MIME pour décoder toutes les formes de Base64
• Traitement 100 % local : tout le décodage s'effectue dans le navigateur, aucune donnée envoyée sur un serveur

Exemples de code

// Decode UTF-8 safe (handles accents, emoji, Chinese, etc.)
function b64Decode(str) {
  // 1. Convert Base64 to binary string (Latin-1)
  const binary = atob(str);
  // 2. Convert binary string to percent-encoded UTF-8
  const percent = Array.from(binary)
    .map(c => '%' + ('00' + c.charCodeAt(0).toString(16)).slice(-2))
    .join('');
  // 3. Decode as UTF-8
  return decodeURIComponent(percent);
}

// URL-Safe decode (for JWT / OAuth)
function b64UrlDecode(str) {
  // Re-add padding
  str = str.replace(/-/g, '+').replace(/_/g, '/');
  while (str.length % 4) str += '=';
  return b64Decode(str);
}

console.log(b64Decode('SGVsbG8g8J+YiQ==')); // Hello 😀
console.log(b64UrlDecode('SGVsbG8g8J-YiQ')); // Hello 😀

import base64

# Standard decode (UTF-8)
decoded = base64.b64decode('SGVsbG8g8J+YiQ==').decode('utf-8')
print(decoded)  # Hello 😀

# URL-Safe decode (for JWT / OAuth)
url_decoded = base64.urlsafe_b64decode('SGVsbG8g8J-YiQ==').decode('utf-8')
print(url_decoded)  # Hello 😀

# Decode without padding (common in JWT)
def b64_decode_no_pad(s):
    s += '=' * (-len(s) % 4)
    return base64.urlsafe_b64decode(s).decode('utf-8')

print(b64_decode_no_pad('SGVsbG8g8J-YiQ'))  # Hello 😀

import java.nio.charset.StandardCharsets;
import java.util.Base64;

public class Base64DecodeExample {
    public static void main(String[] args) {
        String encoded = "SGVsbG8g8J+YiQ==";

        // Standard decode
        String decoded = new String(
            Base64.getDecoder().decode(encoded), StandardCharsets.UTF_8);
        System.out.println(decoded); // Hello 😀

        // URL-Safe decode (for JWT / URL)
        String urlSafe = new String(
            Base64.getUrlDecoder().decode(encoded), StandardCharsets.UTF_8);
        System.out.println(urlSafe);

        // MIME decode (handles line breaks)
        String mimeDecoded = new String(
            Base64.getMimeDecoder().decode(encoded), StandardCharsets.UTF_8);
        System.out.println(mimeDecoded);
    }
}

FAQ

Dépannage

Glossaire

Base64 (RFC 4648)

Schéma de codage binaire-vers-texte utilisant un alphabet de 64 caractères imprimables (A-Z, a-z, 0-9, +, /), défini officiellement par la RFC 4648 §4. Le décodage consiste à regrouper les caractères par paquets de 4 pour reconstituer 3 octets d'origine.

Base64URL (URL-safe Base64)

Variante définie par la RFC 4648 §5. Les caractères + et / sont remplacés par - et _, et le padding = est généralement omis. C'est la forme utilisée dans les tokens JWT, OAuth PKCE, les paramètres d'URL et les noms de fichiers.

MIME Base64 (RFC 2045)

Variante conforme à la RFC 2045, qui insère un saut de ligne (CRLF) tous les 76 caractères. Conçue à l'origine pour le transport des pièces jointes par e-mail via SMTP, qui imposait une limite de longueur par ligne.

Padding (=)

Caractère = ajouté en fin de chaîne Base64 pour que la longueur totale soit un multiple de 4. Le Base64 standard l'utilise systématiquement, le Base64URL l'omet en général. Une erreur de padding est une cause fréquente d'InvalidCharacterError.

InvalidCharacterError

Erreur levée (notamment par la fonction atob en JavaScript) lorsqu'une chaîne contient un caractère absent de l'alphabet Base64 : espaces, retours à la ligne non retirés, guillemets, ou caractères URL-safe (- _) traités comme du Base64 standard.

btoa / atob

API natives du navigateur pour coder (btoa, binary to ASCII) et décoder (atob, ASCII to binary) en Base64. Elles ne manipulent que des chaînes Latin-1 (ISO-8859-1) : pour décoder du texte UTF-8, il faut d'abord décoder avec atob puis réinterpréter les octets via TextDecoder ou unescape/decodeURIComponent.

Encodage de caractères (UTF-8, ASCII, ISO-8859-1)

Façon dont une séquence d'octets est interprétée comme du texte. UTF-8 est l'encodage universel (1 à 4 octets par caractère), ASCII ne couvre que 128 caractères sur 7 bits, ISO-8859-1 (Latin-1) couvre 256 caractères sur 8 bits et convient aux langues occidentales sans accents étendus.

JWT (JSON Web Token)

Jeton signé composé de trois parties (header.payload.signature) encodées en Base64URL. Le header et le payload peuvent être librement décodés en Base64URL pour lire les claims ; la signature ne doit jamais être décodée pour être validée.

Comparaison des trois variantes Base64

Causes fréquentes d'erreur de décodage

Authoritative References

• ReferenceRFC 4648 - The Base16, Base32, and Base64 Data Encodings
• ReferenceRFC 2045 - MIME Part One: Format of Internet Message Bodies
• ReferenceRFC 7519 - JSON Web Token (JWT)
• ReferenceMDN Web Docs - atob()
• ReferenceMDN Web Docs - btoa()
• ReferenceWikipedia - Base64
• ReferenceWHATWG - HTML Living Standard (atob/btoa)