btoa() - Codificar para Base64

A função `btoa()` cria uma string ASCII codificada em Base64 a partir de dados binários.

// Uso básico
const encoded = btoa('Hello World');
console.log(encoded); // "SGVsbG8gV29ybGQ="

// Codificar JSON
const json = JSON.stringify({ name: 'John', age: 30 });
const encodedJson = btoa(json);
console.log(encodedJson); // "eyJuYW1lIjoiSm9obiIsImFnZSI6MzB9"

• > Aceita apenas caracteres ASCII (0-255)
• > Gera erro para caracteres Unicode
• > Disponível em todos os navegadores modernos e Node.js 16+

atob() - Decodificar de Base64

A função `atob()` decodifica uma string codificada em Base64.

// Uso básico
const decoded = atob('SGVsbG8gV29ybGQ=');
console.log(decoded); // "Hello World"

// Decodificar JSON
const decodedJson = atob('eyJuYW1lIjoiSm9obiIsImFnZSI6MzB9');
const data = JSON.parse(decodedJson);
console.log(data); // { name: 'John', age: 30 }

• > Retorna string binária
• > Gera erro para Base64 inválido
• > Entrada sensível a maiúsculas e minúsculas

Tratamento de Unicode

Para strings Unicode, combine com TextEncoder/TextDecoder.

// Codificar Unicode
function encodeUnicode(str) {
  const bytes = new TextEncoder().encode(str);
  const binString = String.fromCharCode(...bytes);
  return btoa(binString);
}

// Decodificar Unicode
function decodeUnicode(base64) {
  const binString = atob(base64);
  const bytes = Uint8Array.from(binString, c => c.charCodeAt(0));
  return new TextDecoder().decode(bytes);
}

// Exemplo
const encoded = encodeUnicode('你好世界 🌍');
const decoded = decodeUnicode(encoded);
console.log(decoded); // "你好世界 🌍"

Casos de Uso Comuns

Aplicações práticas em desenvolvimento web.

Tratamento de Erros

Melhores práticas para código robusto.

function safeBase64Decode(str) {
  try {
    return atob(str);
  } catch (e) {
    console.error('Base64 inválido:', e);
    return null;
  }
}

function safeBase64Encode(str) {
  try {
    return btoa(str);
  } catch (e) {
    // Provavelmente problema com Unicode
    return btoa(unescape(encodeURIComponent(str)));
  }
}

Suporte de Navegadores e Node.js

Disponibilidade em diferentes ambientes.

// Fallback Node.js para versões antigas
if (typeof btoa === 'undefined') {
  global.btoa = (str) => Buffer.from(str, 'binary').toString('base64');
  global.atob = (b64) => Buffer.from(b64, 'base64').toString('binary');
}

Dicas de Performance

Otimizar operações Base64.

// Comparação de performance
const cache = new Map();

function cachedBtoa(str) {
  if (!cache.has(str)) {
    cache.set(str, btoa(str));
  }
  return cache.get(str);
}

• > Cache valores codificados para uso repetido
• > Use streaming para arquivos grandes
• > Considere alternativas para dados binários (ArrayBuffer, Blob)
• > Agrupe operações quando possível