Base64 Encode e Decode

O que é Base64 e por que existe

O Base64 representa bytes arbitrários usando só 64 caracteres seguros: A–Z, a–z, 0–9, + e /. Cada três bytes de entrada viram quatro caracteres de saída, e quando o tamanho da entrada não é múltiplo de três, um ou dois sinais = completam o final.

Ele existe porque muitos canais foram feitos para texto, não para dados binários. E-mail (MIME), JSON, XML, atributos HTML, cabeçalhos HTTP e variáveis de ambiente transportam Base64 com segurança onde bytes brutos seriam corrompidos. Por isso ele aparece em anexos de e-mail, URIs data:, cabeçalhos de autenticação Basic, JSON Web Tokens e payloads de API que embutem arquivos.

Base64 é uma codificação, não criptografia. Qualquer um pode decodificar, então não esconde nada; se um valor precisa ficar secreto, criptografe-o. Se você precisa verificar que os dados não mudaram, um checksum do gerador de hash é a ferramenta certa.

Base64 padrão, Base64URL e quebra de linha

O decodificador aceita todas essas formas: qualquer um dos alfabetos, com ou sem preenchimento, com ou sem quebras de linha e espaços. Um URI data:…;base64, completo pode ser colado como está.

Padrão (RFC 4648)

Usa + e / e completa com =. É o que MIME, URIs data, a maioria das bibliotecas e a ferramenta de linha de comando base64 produzem.

Seguro para URL, Base64URL

Troca + por - e / por _ para que o resultado possa ficar em uma URL ou nome de arquivo sem percent-encoding. Os JWTs o usam sem o preenchimento, e é por isso que a opção de preenchimento existe.

Quebra de linha MIME

O e-mail exige linhas de no máximo 76 caracteres, então os codificadores MIME inserem uma quebra de linha a cada 76 caracteres. Ative ao colar no código-fonte de um e-mail ou em um bloco no estilo PEM; deixe desligado para JSON, URLs e código.

Por que o texto precisa virar UTF-8 primeiro

O Base64 codifica bytes, não caracteres, então o texto precisa virar bytes antes de ser codificado. O btoa() nativo do navegador só aceita caracteres até U+00FF e dá erro com qualquer outro, por isso codificadores ingênuos falham com "€", "日本" ou um emoji. Esta ferramenta codifica o texto em UTF-8, a codificação que quase todo sistema espera, então é vira os dois bytes C3 A9 e é decodificado de volta para é em qualquer plataforma.

Ao decodificar, os bytes são verificados para ver se são UTF-8 válido. Se não forem, o Base64 quase certamente contém um arquivo binário em vez de texto, e a ferramenta avisa — e diz que tipo de arquivo é quando reconhece a assinatura — em vez de mostrar uma tela de caracteres sem sentido.

Arquivos: tamanho, assinaturas e entradas grandes

O Base64 deixa os dados cerca de um terço maiores: quatro caracteres para cada três bytes, mais quebras de linha se você quebrar. Uma imagem de 3 MB vira cerca de 4 MB de texto. A visão de arquivo mostra os dois tamanhos antes de você copiar qualquer coisa, o que vale conferir antes de embutir um arquivo grande em uma folha de estilo ou em um documento JSON.

Decodificar uma string Base64 para arquivo funciona ao contrário. Os primeiros bytes da maioria dos formatos são uma assinatura fixa — 89 50 4E 47 para PNG, %PDF para PDF, PK para ZIP (e portanto DOCX e XLSX) — então a ferramenta os lê para nomear o download corretamente e mostrar a prévia de imagens. Arquivos grandes são codificados em partes com uma barra de progresso, para a página continuar responsiva, e resultados muito longos são mostrados em parte, enquanto copiar e baixar sempre entregam tudo.

Especificamente para imagens, o conversor de imagem para Base64 também gera trechos de HTML, CSS e Markdown prontos para colar.