Codificador de Arquivo Base64

O que é Codificação de Arquivo Base64?

A codificação de arquivo Base64 converte arquivos binários — PDFs, ZIPs, imagens, executáveis, fontes, áudio — em texto ASCII plano usando o alfabeto definido em RFC 4648. Cada três bytes de entrada binária se tornam quatro caracteres Base64, produzindo uma representação de texto que pode viajar por canais projetados exclusivamente para texto: cargas úteis de API JSON, documentos XML, corpos de e-mail, atributos HTML e variáveis de ambiente.

Ao contrário da codificação texto-para-Base64 (que funciona em strings), a codificação arquivo-para-Base64 lê o fluxo de bytes bruto de qualquer arquivo independentemente de seu formato. Os cabeçalhos binários de um PDF, os blocos comprimidos de um ZIP e os dados de pixels de um PNG são todos tratados de forma idêntica: como uma sequência de octetos a ser recodificada. O resultado é sempre ASCII válido, seguro para incorporar em qualquer lugar que aceite caracteres imprimíveis.

O compromisso é o tamanho: a saída Base64 é aproximadamente 33% maior que o binário original. Para um PDF de 1 MB, isso significa aproximadamente 1,33 MB de texto Base64. Essa sobrecarga é inerente à codificação e nenhuma implementação pode evitá-la. Apesar disso, a codificação de arquivo Base64 permanece o método padrão para incorporar dados binários em formatos somente texto, especificado em MIME (RFC 2045), URIs de dados (RFC 2397) e Tokens Web JSON (RFC 7519).

Por Que Usar Este Codificador de Arquivo Base64?

Esta ferramenta codifica arquivos em Base64 diretamente no seu navegador usando a API FileReader. Nenhum arquivo é enviado para um servidor — toda a conversão acontece no lado do cliente em JavaScript.

Casos de Uso de Codificação de Arquivo Base64

Sobrecarga de Tamanho de Arquivo Base64

A codificação Base64 aumenta o tamanho dos dados em exatamente um terço. Cada 3 bytes de entrada produzem 4 caracteres de saída (cada um representando 6 bits). Caracteres de preenchimento (=) são adicionados quando o comprimento de entrada não é múltiplo de 3. A tabela abaixo mostra a relação entre o tamanho do arquivo original e o tamanho da saída codificada.

Referência de URI de Dados e Tipo MIME

Um URI de dados incorpora conteúdo de arquivo diretamente em HTML, CSS ou JavaScript usando o formato data:[tipo MIME];base64,[dados codificados]. O tipo MIME informa ao navegador como interpretar os bytes decodificados. Abaixo estão extensões de arquivo comuns, seus tipos MIME e o prefixo de URI de dados correspondente.

Exemplos de Código

Estes exemplos executáveis mostram como ler um arquivo binário e codificá-lo em Base64 em JavaScript, Python, Node.js, bash e Go. Cada trecho produz Base64 padrão (RFC 4648 Seção 4) com preenchimento.

// Read a file from an <input> element and encode to Base64
const input = document.querySelector('input[type="file"]')
input.addEventListener('change', (e) => {
  const file = e.target.files[0]
  const reader = new FileReader()
  reader.onload = () => {
    const base64 = reader.result.split(',')[1]
    console.log(base64) // → "JVBERi0xLjQK..." (raw Base64, no data URI prefix)
  }
  reader.readAsDataURL(file)
})

// Convert a Blob to Base64 with async/await
async function blobToBase64(blob) {
  const buffer = await blob.arrayBuffer()
  const bytes = new Uint8Array(buffer)
  let binary = ''
  bytes.forEach(b => binary += String.fromCharCode(b))
  return btoa(binary) // → standard Base64 string
}

import base64
from pathlib import Path

# Encode a file to Base64
file_bytes = Path('document.pdf').read_bytes()
encoded = base64.b64encode(file_bytes).decode('ascii')
print(encoded[:40])  # → "JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PA..."

# Write encoded output to a text file
Path('document.b64.txt').write_text(encoded)

# Build a data URI from a file
mime_type = 'application/pdf'
data_uri = f'data:{mime_type};base64,{encoded}'
print(data_uri[:60])  # → "data:application/pdf;base64,JVBERi0xLj..."

import { readFileSync, writeFileSync } from 'fs'

// Encode a file to Base64
const buffer = readFileSync('archive.zip')
const base64 = buffer.toString('base64')
console.log(base64.length) // → 1398104 (for a ~1 MB file)

// Save Base64 output to a file
writeFileSync('archive.b64.txt', base64)

// Build a data URI
const mime = 'application/zip'
const dataUri = `data:${mime};base64,${base64}`

# Encode a file to Base64 (macOS / Linux)
base64 < document.pdf > document.b64.txt

# Encode with no line wrapping (GNU coreutils)
base64 -w 0 < document.pdf > document.b64.txt

# Encode and copy to clipboard (macOS)
base64 < image.png | pbcopy

# Encode with OpenSSL (available everywhere)
openssl base64 -in archive.zip -out archive.b64.txt

# Pipe directly into curl for API upload
base64 -w 0 < photo.jpg | curl -X POST -d @- https://api.example.com/upload

package main

import (
	"encoding/base64"
	"fmt"
	"os"
)

func main() {
	data, err := os.ReadFile("document.pdf")
	if err != nil {
		panic(err)
	}
	encoded := base64.StdEncoding.EncodeToString(data)
	fmt.Println(len(encoded)) // → 1398104 (for a ~1 MB file)

	// Write to file
	os.WriteFile("document.b64.txt", []byte(encoded), 0644)
}

Perguntas Frequentes