Descodificació Base64

Relacionats

Què és la descodificació Base64?

Casos d'ús

• Descodificar camps Base64 retornats per una API per veure el contingut original
• Restaurar dades codificades en Base64 dins de registres
• Recuperar valors Base64 dins de fitxers de configuració
• Diagnosticar errors de descodificació Base64 com manca de padding o caràcters no vàlids
• Descodificar els segments header i payload de JWT per consultar informació d'usuari
• Descodificar credencials HTTP Basic Authentication per veure usuari i contrasenya
• Restaurar dades d'imatges o recursos dins d'un Data URI Scheme

Com usar-ho

1. Enganxa la cadena Base64 que vols descodificar
2. Tria el joc de caràcters (UTF-8/ASCII/ISO-8859-1)
3. L'eina descodifica automàticament el Base64 i mostra el resultat
4. Copia el resultat descodificat per continuar amb la depuració o la documentació

Característiques

• Conversió bidireccional en temps real: l'entrada es descodifica immediatament amb un retard antirebot de 300 ms, sense necessitat d'executar res manualment
• Compatibilitat amb múltiples jocs de caràcters: UTF-8, ASCII i ISO-8859-1 per cobrir escenaris en català, anglès i multilingües
• Compatibilitat amb URL-safe Base64: gestiona automàticament la substitució de `-` i `_` i admet formats sense Padding
• Detecció de caràcters no vàlids: quan la descodificació falla, mostra la posició concreta de l'error per localitzar el problema més ràpid
• Copiar i descarregar amb un clic: permet copiar el resultat descodificat al porta-retalls o descarregar-lo com a fitxer de text `.txt`
• Gestió automàtica del Padding: completa o elimina automàticament els caràcters `=` sense ajustar manualment la longitud
• Compatibilitat amb la variant MIME: reconeix i processa Base64 MIME amb salts de línia cada 76 caràcters, habitual en adjunts de correu

Exemples de codi

// Standard Base64 decode (plain English / Latin-1)
function b64Decode(str) {
  try {
    return atob(str);
  } catch (e) {
    return 'Decode failed: ' + e.message;
  }
}

console.log(b64Decode('SGVsbG8gV29ybGQ=')); // "Hello World"

// UTF-8 decode (recommended)
function b64DecodeUtf8(str) {
  const binary = atob(str);
  const bytes = new Uint8Array(binary.length);
  for (let i = 0; i < binary.length; i++) {
    bytes[i] = binary.charCodeAt(i);
  }
  return new TextDecoder('utf-8').decode(bytes);
}

console.log(b64DecodeUtf8('5LiW55WM')); // UTF-8 text

import base64

# Standard decode
encoded = 'SGVsbG8g5LiW55WM'
decoded = base64.b64decode(encoded).decode('utf-8')
print(decoded)

# URL-Safe decode
url_encoded = 'SGVsbG8g5LiW55WM'
decoded = base64.urlsafe_b64decode(url_encoded + '=' * (4 - len(url_encoded) % 4))
print(decoded.decode('utf-8'))

# MIME decode (after removing line breaks)
mime_encoded = 'SGVs\nbG8g\nV29y\nbGQ='
decoded = base64.b64decode(mime_encoded.replace('\n', '')).decode('utf-8')
print(decoded)

# Ignore invalid characters automatically
import re
cleaned = re.sub(r'[^A-Za-z0-9+/=]', '', encoded)
decoded = base64.b64decode(cleaned).decode('utf-8')
print(decoded)

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

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

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

        // URL-Safe decode
        byte[] urlDecoded = Base64.getUrlDecoder().decode(encoded);
        System.out.println(new String(urlDecoded, StandardCharsets.UTF_8));

        // MIME decode (handles line breaks automatically)
        String mime = "SGVs\nbG8g\nV29y\nbGQ=";
        byte[] mimeDecoded = Base64.getMimeDecoder().decode(mime);
        System.out.println(new String(mimeDecoded, StandardCharsets.UTF_8));

        // Error handling
        try {
            Base64.getDecoder().decode("invalid@base64");
        } catch (IllegalArgumentException e) {
            System.err.println("Decode failed: " + e.getMessage());
        }
    }
}

Preguntes freqients

Glossari

Base64

Mètode de codificació de binari a text basat en 64 caràcters ASCII imprimibles, definit a RFC 4648. Cada 3 bytes es codifiquen com 4 caràcters, de manera que la mida augmenta aproximadament un 33%.

atob()

Funció nativa del navegador per descodificar Base64 (ASCII to Binary). Només admet el joc de caràcters Latin-1; per processar text UTF-8 cal combinar-la amb TextDecoder.

Padding (farciment)

La codificació Base64 afegeix caràcters `=` al final per completar una longitud múltiple de 4. En descodificar, el padding normalment s'elimina automàticament. La variant URL-safe sovint l'omet.

URL-Safe Base64

Variant segura per a URL definida a RFC 4648 §5, que utilitza `-` i `_` en lloc de `+` i `/` per evitar problemes d'URL. És habitual en JWT i OAuth PKCE.

MIME Base64

Variant Base64 definida a RFC 2045 que insereix un salt de línia CRLF cada 76 caràcters. S'utilitza principalment per transmetre adjunts de correu.

UTF-8

Codificació Unicode de longitud variable: el xinès ocupa 3 bytes i l'anglès 1 byte. Cal indicar UTF-8 en descodificar Base64 per restaurar correctament caràcters multibyte.

InvalidCharacterError

Error que llança `atob()` al navegador quan troba caràcters que no són Base64, com espais, salts de línia o caràcters xinesos. Indica que l'entrada conté caràcters no vàlids.

Latin-1 (ISO-8859-1)

Joc de caràcters d'un sol byte que cobreix llengües d'Europa occidental. `atob` i `btoa` del navegador només admeten aquest joc i no poden processar directament UTF-8.

Comparació de les tres variants Base64

Abans de descodificar, identifica el tipus de variant Base64 d'entrada i tria el mode adequat per evitar errors o text malmès.

Taula de 5 errors habituals en descodificar Base64

Si tens errors en descodificar, fes servir aquesta taula per localitzar-ne la causa ràpidament.

Authoritative References

• IETFRFC 4648 - Codificacions de dades Base16, Base32 i Base64
• IETFRFC 2045 - MIME Part One: Format of Internet Message Bodies
• IETFRFC 7519 - JSON Web Token (JWT)
• MDNMDN - Window atob()
• MDNMDN - Window btoa()
• MDNMDN - TextDecoder
• WikipediaWikipedia - Base64