Limpeza de Base64
Ferramenta de limpeza de Base64 online grátis que remove conteúdo inválido como quebras de linha, espaços em branco e caracteres invisíveis de strings Base64. Suporta três opções independentes: remover espaços em branco, remover caracteres especiais e completar automaticamente o preenchimento, gerando Base64 estritamente conforme a RFC 4648.
Sugestões Relacionadas
O que é limpeza de Base64?
A limpeza de Base64 é a operação de remover todos os caracteres inválidos e redundantes de uma string Base64. O objetivo é gerar Base64 puro estritamente conforme o padrão RFC 4648, facilitando a transmissão, armazenamento e decodificação entre diferentes sistemas.
Por que limpar: O Base64 de diferentes fontes frequentemente contém caracteres inválidos misturados. ① Quebras de linha (\n, \r\n) — anexos de e-mail, campos de banco de dados, saídas de log; ② Espaços em branco e tabulação — colagem manual, cópia do Excel; ③ BOM UTF-8 (EF BB BF) — arquivos de texto salvos no Windows; ④ Símbolos de largura total e pontuação chinesa — erros de cópia e colagem. Tudo isso pode causar erros no decodificador.
Três opções de limpeza: ① Remover espaços em branco (\s \n \r \t) — processar quebras de linha e espaços; ② Remover caracteres especiais — manter apenas o alfabeto Base64 A-Z a-z 0-9 + / = - _; ③ Completar automaticamente o preenchimento — fazer com que o comprimento do resultado seja múltiplo de 4. As três opções podem ser marcadas independentemente e combinadas conforme necessário.
Usos típicos: ① Depuração de API — limpar ao colar Base64 retornado por interfaces de terceiros que causam erros; ② Importação para banco de dados — remover espaços em branco extras trazidos ao copiar do Excel; ③ Pré-processamento antes da decodificação — evitar InvalidCharacterError no atob(); ④ Normalização de JWT / Data URL — lidar com diferenças de transmissão entre sistemas.
Casos de uso
- Pré-processamento antes da decodificação: limpe o Base64 com quebras de linha ou espaços de interfaces de terceiros, JWT e logs para um formato diretamente decodificável, evitando InvalidCharacterError.
- Reparo de colagem do Excel / e-mail: remova espaços em branco extras, tabulações e quebras de linha misturados ao copiar Base64 de células do Excel ou corpo de e-mail.
- Limpeza de token JWT: normalize a string de três partes do JWT (header.payload.signature) com quebras de linha em uma única linha, removendo espaços em branco extras.
- Processamento de anexos MIME: limpe a formatação com quebra automática a cada 76 caracteres no Base64 de anexos de e-mail para facilitar a decodificação posterior.
- Compatibilidade URL Segura: preserve os caracteres - e _ para que o Base64 em JWT, caminhos de URL e nomes de arquivo não seja excluído acidentalmente.
- Pré-processamento antes da limpeza em lote: use em conjunto com base64-format / base64-padding, limpando primeiro antes de formatar ou completar.
Como Usar
- Cole ou insira a string Base64 com ruído (pode conter caracteres inválidos como quebras de linha e espaços).
- Marque as opções de limpeza conforme necessário: remover espaços em branco, remover caracteres especiais, completar automaticamente o preenchimento (as três opções vêm marcadas por padrão).
- Veja a saída à direita: exibe em tempo real o Base64 limpo, contagem de caracteres, caracteres removidos e legalidade da decodificação.
- Copie o resultado para a área de transferência ou baixe como arquivo .txt para processamento posterior.
Recursos
- Opção Remover espaços em branco: remove automaticamente \n, \r, \t e espaços, lidando com cenários como anexos de e-mail e colagem do Excel.
- Opção Remover caracteres especiais: mantém apenas 66 caracteres Base64 válidos: A-Z a-z 0-9 + / = - _.
- Completar preenchimento automaticamente: pode ser marcado para fazer com que o comprimento do resultado seja múltiplo de 4, corrigindo erros de comprimento.
- Três opções independentes e combináveis: marque conforme necessário para lidar flexivelmente com diferentes situações de contaminação.
- Preservação de caracteres URL Seguro: não exclui acidentalmente - e _, evitando perda de caracteres em cenários JWT / URL.
- Verificação de saída em tempo real: usa atob() do navegador para verificar se a saída pode ser decodificada, com status exibido em tempo real.
- Contagem de caracteres e notificação de remoção: exibe em tempo real número de caracteres de entrada/saída, caracteres removidos e status de decodificação.
- Processamento local no navegador: todas as operações de limpeza são feitas localmente, o Base64 original não é enviado a nenhum servidor.
Best Practices
Primeiro limpe, depois use a ferramenta de preenchimento para completar
A limpeza apenas remove caracteres inválidos e opcionalmente completa o preenchimento. Se o Base64 tiver quebras de linha e preenchimento ausente simultaneamente, recomendamos marcar todas as três opções de limpeza primeiro e depois observar se o comprimento da saída ainda não é múltiplo de 4. Se ainda houver anomalia de preenchimento, você pode usar a ferramenta de preenchimento dedicada.
Processe separadamente as três partes do token JWT
O JWT é um todo de três partes Base64URL conectadas por . (header.payload.signature). Durante a limpeza, as três partes precisam ter os espaços em branco removidos, mas não insira caracteres extras entre as partes, senão a verificação de assinatura falhará. Recomendamos dividir por . antes de colar, limpar cada parte separadamente e depois concatenar.
Para entrada URL Segura, não marque "Remover caracteres especiais"
O Base64 URL Seguro substitui + e / por - e _. Esta ferramenta mantém esses 4 caracteres por padrão, mas se você definir manualmente uma lista branca de caracteres mais restrita (permitindo apenas +/), a entrada URL Segura será danificada. Se não tiver certeza do conjunto de caracteres, desligue "Remover caracteres especiais" e mantenha apenas "Remover espaços em branco".
Ainda dá erro após a limpeza → verifique codificação e BOM
Se o atob() ainda reportar InvalidCharacterError após a limpeza, pode ser BOM UTF-8 (EF BB BF) ou resíduos de ordem de byte UTF-16. A opção "Remover espaços em branco" desta ferramenta não visa o BOM; recomendamos decodificar novamente como UTF-8 com TextDecoder no console do navegador e depois limpar novamente.
Identificação da origem do BOM: txt salvo no Windows
Se o Base64 foi obtido ao salvar como UTF-8 no Bloco de Notas do Windows, os primeiros 3 bytes (EF BB BF) são o BOM. Mesmo após limpar espaços em branco e quebras de linha, o atob ainda pode falhar na identificação. Método de tratamento: salve novamente como formato UTF-8 sem BOM usando VS Code ou PowerShell.
Mostre comparações antes e depois da limpeza ao ensinar e em demonstrações de documentação
A limpeza de Base64 é um problema comum no ensino. Recomenda-se anexar tanto o Base64 antes quanto depois da limpeza ao escrever documentação, juntamente com comparações de contagem de caracteres e status de decodificação, para que os leitores entendam intuitivamente a função de cada opção.
Perguntas frequentes
A limpeza de Base64 altera os bytes originais?
Não. A limpeza apenas remove caracteres inválidos (espaços em branco, quebras de linha, caracteres não Base64), não modifica os caracteres válidos no meio. Se apenas remover espaços em branco e caracteres ilegais, o conteúdo em bytes antes e depois da limpeza é exatamente o mesmo. Se marcar "Completar automaticamente o preenchimento", apenas acrescenta = no final, sem afetar os bytes originais.
Qual a diferença entre as três opções de limpeza?
Remover espaços em branco: remove \s \n \r \t (espaços, quebras de linha, retorno de carro, tabulação). Remover caracteres especiais: mantém apenas 66 caracteres Base64 válidos A-Z a-z 0-9 + / = - _. Completar automaticamente o preenchimento: acrescenta = no final para que o comprimento seja múltiplo de 4. As três opções são independentes e combináveis.
Por que o atob() reporta InvalidCharacterError?
Causas comuns: ① Contém caracteres chineses, emojis Unicode ou outros caracteres não ASCII; ② Contém quebras de linha ou espaços em branco (situação comum ao copiar do Excel ou colar de e-mail); ③ Mistura de caracteres Base64URL (- / _); ④ Comprimento não é múltiplo de 4. A limpeza desta ferramenta resolve os primeiros 3 problemas; a ferramenta de preenchimento resolve o quarto.
A limpeza remove o preenchimento?
Não. = é um caractere válido do Base64; a opção "Remover caracteres especiais" desta ferramenta o mantém explicitamente. Se quiser remover o preenchimento, use a ferramenta dedicada de preenchimento (base64-padding) alternando para o modo "Remover preenchimento".
Como limpar se contiver quebras de linha?
Marque "Remover espaços em branco" por padrão para processar. Quebras de linha (\n / \r\n), tabulações e espaços serão removidos. Se precisar manter as quebras de linha (formato de anexo de e-mail MIME), desligue a opção "Remover espaços em branco".
Esta ferramenta consegue lidar com UTF-8 BOM?
O BOM (EF BB BF) é o caractere Unicode U+FEFF; a opção "Remover espaços em branco" desta ferramenta usa a expressão regular \s \n \r \t que não inclui U+FEFF, portanto o BOM pode permanecer. Se encontrar InvalidCharacterError causado por BOM, recomendamos remover o BOM primeiro com TextDecoder no código ou no console do navegador.
Os caracteres URL Seguro e Base64 padrão são convertidos entre si?
Não. A opção "Remover caracteres especiais" desta ferramenta mantém os quatro caracteres + / - _, apenas remove ruído sem conversão ativa. Se precisar de conversão mútua entre URL Seguro ↔ caracteres padrão, use a ferramenta dedicada Base64URL (base64-url-safe).
Meu conteúdo é enviado para o servidor?
Não. Toda a lógica de limpeza é executada localmente no navegador; a string Base64 original não sai do seu dispositivo. Você pode usar com confiança mesmo para processar dados sensíveis (credenciais, chaves secretas, tokens).
Posso limpar vários trechos de Base64 de uma vez?
Esta ferramenta tem interface de limpeza de trecho único. Se tiver vários trechos de Base64 para limpar, recomendamos chamar a lógica desta ferramenta em loop ou usar ferramentas de linha de comando correspondentes (como o comando base64). Se precisar codificar/decodificar em lote, use base64-batch-encode / base64-batch-decode.
Solução de Problemas
atob ainda dá erro após a limpeza
Pode ser problema de comprimento (não é múltiplo de 4) ou resíduos de BOM / codificação. Primeiro confirme que marcou "Completar automaticamente o preenchimento"; se ainda der erro, tente decodificar novamente como UTF-8 com TextDecoder no console do navegador, remova o BOM e depois limpe novamente.
O comprimento mudou após a limpeza, mas a decodificação ainda falha
Pode ser que o conteúdo original não seja Base64 padrão, por exemplo Base32 / Base58 / Base85. Confirme o formato de codificação dos dados originais e alterne para a ferramenta correspondente. Você também pode tentar usar btoa antes do atob para testar se a string original pode ser recodificada.
Os caracteres ficaram muito poucos após a limpeza
Muito provavelmente a opção "Remover caracteres especiais" está muito restrita, removendo também + / - _. Verifique se desativou acidentalmente a lista branca de caracteres; esta ferramenta mantém por padrão todos os 66 caracteres Base64 válidos. Se a entrada for URL Segura, basta desligar "Remover caracteres especiais".
Nenhuma saída após colar
Pode ser que a entrada seja inteiramente de espaços em branco (contém apenas espaços / quebras de linha / tabulação); a opção "Remover espaços em branco" desta ferramenta remove tudo deixando string vazia. Verifique se a entrada original contém pelo menos um caractere Base64 (A-Z a-z 0-9 + / =).
Glossário
- UTF-8 BOM
- Marca de ordem de byte. Prefixo de 3 bytes (0xEF 0xBB 0xBF) anexado ao salvar texto UTF-8 no Windows, que faz com que o decodificador Base64 trate o primeiro caractere como byte inválido.
- Base64 URL Seguro
- Variante Base64 segura para URL definida pela RFC 4648 §5, que substitui + e / por - e _. A opção "Remover caracteres especiais" desta ferramenta mantém esses 4 caracteres para evitar exclusão acidental.
- Quebras de linha
- \r\n (Windows) e \n (Unix / macOS). O Base64 MIME de anexos de e-mail geralmente quebra linha a cada 76 caracteres, sendo necessário remover durante a limpeza.
- Caracteres Base64 válidos
- O conjunto de caracteres Base64 padrão é A-Z, a-z, 0-9, +, /, = (preenchimento), mais - e _ da variante URL Segura, totalizando 66 caracteres válidos.
- InvalidCharacterError
- Erro de decodificação lançado pelo atob() do navegador. É acionado quando uma string Base64 contém caracteres fora da tabela de caracteres válidos (chinês, espaços em branco, símbolos especiais, etc.).
Conjunto de caracteres Base64 e regras de preservação
Tabela de caracteres válidos mantidos pela opção "Remover caracteres especiais" desta ferramenta.
| Tipo de caractere | Caracteres | Regra de preservação |
|---|---|---|
Letras | A-Z, a-z | 52 caracteres, mantidos obrigatoriamente |
Números | 0-9 | 10 caracteres, mantidos obrigatoriamente |
Símbolos Base64 padrão | + / | 2 caracteres, mantidos obrigatoriamente |
Símbolos URL Seguro | - _ | 2 caracteres, mantidos obrigatoriamente em cenários URLSafe |
Preenchimento | = | Preenchimento no final, mantido obrigatoriamente |
Espaços em branco | espaços, \n, \r, \t | Removidos conforme opção "Remover espaços em branco" |
Outros | Chinês / emojis / BOM etc. | Removidos conforme opção "Remover caracteres especiais" |
5 fontes comuns de contaminação do Base64
Entenda como conteúdo inválido é misturado às strings Base64.
| Fonte da contaminação | Conteúdo misturado | Opção recomendada |
|---|---|---|
Anexos de e-mail | \r\n a cada 76 caracteres | Remover espaços em branco |
Colagem do Excel / banco de dados | espaços antes/depois / tabulação | Remover espaços em branco |
Arquivo txt do Windows | UTF-8 BOM (EF BB BF) | Remover caracteres especiais + remover BOM manualmente |
URL / nome de arquivo | conflito de caracteres + / | Manter URLSeguro (usar base64-url-safe para conversão) |
Saída de log / trace | prefixo / sufixo de depuração | Remover caracteres especiais |
Comparação das 3 opções de limpeza
As três opções são independentes e combináveis; use-as conforme necessário.
| Opção | Comportamento | Cenário típico |
|---|---|---|
Remover espaços em branco | Remove \s \n \r \t | E-mail / Excel / logs |
Remover caracteres especiais | Mantém apenas o alfabeto Base64 | Mistura de chinês / emojis / BOM |
Completar preenchimento automaticamente | Acrescenta = no final até múltiplo de 4 | Comprimento não é múltiplo de 4 |
Authoritative References
- Comparação Segura de Strings
- Conversão Binária
- Cifra de César
- Código Morse
- Codificação/Decodificação Hexadecimal
- Vídeo para Base64
- Base64 para Vídeo
- Imagem para Base64
- Base64 para Imagem
- Texto para Base64
- Base64 para Texto
- Verificador de hash de arquivo
- Arquivo para Base64
- Base64 para Arquivo
- Áudio para Base64
- Base64 para Áudio
- Criptografar e descriptografar AES
- Criptografia DES
- Codificador e Decodificador Base32
- Codificar e decodificar Base58
- Codificação Base64
- Decodificação Base64
- Comparação Base64
- Dividir Base64
- Mesclar Base64 em várias linhas
- Formatação Base64
- Verificação de Formato Base64
- Codificação Base64 em lote
- Decodificação Base64 em Lote
- Limpeza de Base64
- Preenchimento Base64
- Estatísticas Base64
- Base64 para Hexadecimal
- Conversor Base64 DataURL
- Conversor Base64-Hex
- Codificador Base85
- Gerador e Verificador HMAC
- Derivação de Chave PBKDF2
- Hash MD5
- Hash SHA-256
- Hash SHA1
- Hash SHA512
- Ferramenta JWT
- Codificação e Decodificação HTML
- Escape Unicode
- Codificação URL
- Base64 URL Safe
- MIME Base64
- Ofuscador Java
- Ofuscador JS
- Ofuscador PHP
- Ofuscação Python