Base64 para arquivo: decodifique os bytes e salve o conteúdo correto
Admin ·
Base64 para arquivo recupera os bytes representados por uma sequência Base64 e prepara um download. Cole o valor codificado, escolha um nome, clique em Decodificar arquivo, confira o tamanho informado e baixe o resultado. O conteúdo pode ser uma imagem, um documento, um arquivo compactado ou outros dados binários, desde que esses tenham sido os bytes codificados originalmente.
Uma decodificação bem-sucedida responde a uma pergunta: esta entrada pode representar bytes segundo as regras da ferramenta? Ela não identifica o formato original, recupera partes ausentes nem prova que o arquivo é seguro. Este guia explica as formas aceitas e as verificações úteis para escolher o nome e reconhecer uma entrada incompleta.
Recupere um arquivo a partir do valor codificado
Cole o valor completo em Entrada Base64 e informe o Nome do arquivo desejado. Clique em Decodificar arquivo. Se a validação passar, Tamanho decodificado mostrará a quantidade de bytes e o nome ajustado, e o botão Baixar arquivo ficará disponível. Baixar é uma ação separada: decodificar, por si só, não salva o arquivo no dispositivo.
Para um teste pequeno, cole SGVsbG8= e use o nome hello.txt. O resultado contém cinco bytes que formam Hello, sem uma quebra de linha adicional. Para um arquivo real, procure saber o tipo e o tamanho esperados com a fonte dos dados. Este espaço recebe texto colado, não um arquivo enviado, um endereço remoto ou um lote de arquivos codificados.
- Copie o valor codificado completo, sem aspas JSON nem rótulos de logs.
- Escolha uma extensão correspondente ao conteúdo original.
- Compare a quantidade de bytes decodificados com o tamanho esperado pelo remetente antes de salvar.
RFC 4648: codificações de dados Base16, Base32 e Base64MDN: HTMLAnchorElement.download
Base64 representa bytes; o significado vem do conteúdo
Três bytes costumam ser representados por quatro símbolos Base64. Para um arquivo não vazio com n bytes, a representação com preenchimento contém 4 × ceil(n / 3) símbolos, sem contar o cabeçalho de uma URL de dados ou os espaços acrescentados. Um arquivo de um byte exige quatro símbolos com preenchimento; portanto, o acréscimo de tamanho não é exatamente um terço em todos os casos. Base64 muda a representação, não comprime os dados.
O decodificador preserva os bytes, inclusive bytes de valor zero e valores que não formam texto legível. Ele não interpreta um PDF ou uma imagem como texto Unicode. Se os bytes originais contêm texto UTF-8, um editor adequado pode exibi-lo; outra codificação de caracteres pode exigir uma configuração diferente no editor. Para apenas codificar ou decodificar um trecho de texto, a ferramenta separada de codificação e decodificação Base64 pode ser mais apropriada.
| Base64 | Conteúdo recuperado | Quantidade de bytes |
|---|---|---|
| Zg== | A letra f | 1 |
| Zm8= | As letras fo | 2 |
| Zm9v | As letras foo | 3 |
| AP8= | Bytes binários 00 FF em hexadecimal | 2 |
RFC 4648: codificações de dados Base16, Base32 e Base64MDN: Window.atob()MDN: construtor Blob
Use um alfabeto compatível de cada vez
O Base64 padrão usa letras, números, mais e barra. A variante segura para URLs substitui os dois últimos símbolos por hífen e sublinhado. O ToolMellow aceita qualquer um desses alfabetos e normaliza a forma segura para URLs antes da decodificação. O preenchimento final correto é aceito; também é possível omiti-lo quando os símbolos restantes formam um grupo final válido.
Não misture símbolos exclusivos dos dois alfabetos no mesmo valor. Por exemplo, //8= e __8= recuperam dois bytes de valor 255, mas _/8= é rejeitado. Ser seguro para URLs não permite colar um endereço completo: a ferramenta não acessa links, extrai parâmetros de consulta nem separa as partes de um JSON Web Token. Primeiro obtenha o campo que contém o valor codificado.
A URL de dados envolve o conteúdo, mas não o converte
A forma aceita é data:...;base64,payload, com um cabeçalho sem espaços nem vírgulas antes da vírgula separadora. O prefixo data e o marcador base64 são reconhecidos sem distinguir maiúsculas de minúsculas. Por exemplo, data:text/plain;base64,SGVsbG8= produz os mesmos cinco bytes que o valor isolado. O tipo de mídia declarado é descartado; ele não determina o nome do download nem o tipo de conteúdo da saída.
Nem toda URL de dados usa Base64. A forma data:text/plain,Hello não é aceita por esta ferramenta. Os escapes percentuais do conteúdo também não são decodificados: %3D continua inválido, em vez de virar um sinal de igual. Uma string JSON, uma barra escapada ou uma URL codificada pode exigir a extração ou decodificação da camada correspondente antes de fornecer o Base64 pretendido. Só remova essa camada quando o formato de origem assim exigir.
| Forma da entrada | Comportamento da ferramenta | O que conferir |
|---|---|---|
| SGVsbG8= | Decodifica o conteúdo isolado | Use o valor codificado completo. |
| data:text/plain;base64,SGVsbG8= | Remove o cabeçalho aceito e decodifica | O cabeçalho não escolhe um nome nem converte os bytes. |
| data:text/plain,Hello | Rejeita a forma sem Base64 | Procure o decodificador adequado a essa URL de dados. |
| data:text/plain;base64,SGVsbG8%3D | Rejeita o escape percentual no conteúdo | Verifique se há uma camada externa de codificação de URL a remover. |
O preenchimento exige mais que sinais de igual no final
O preenchimento completa o último grupo quando a quantidade original de bytes não é divisível por três. Zg== e a forma sem preenchimento Zg representam um byte; Zm8= e Zm8 representam dois. Um grupo final com apenas um símbolo não pode representar um byte completo. Sinais de igual no meio, preenchimento excessivo ou incompatível com o grupo final são rejeitados.
Os bits não utilizados no último símbolo também precisam ser zero. Alguns decodificadores permissivos conseguem obter um byte de Zh==, mas esta ferramenta o rejeita: a codificação canônica da letra f é Zg==. Da mesma forma, Zm9= é rejeitado e Zm8= é aceito. Após decodificar, a ferramenta recodifica os bytes e compara o resultado com a entrada normalizada, sem preenchimento. Isso verifica a representação canônica, não a integridade do arquivo original.
RFC 4648: codificações de dados Base16, Base32 e Base64MDN: Window.atob()
Conte a entrada antes de remover cabeçalhos e espaços
A entrada pode ter no máximo 16777216 unidades de código UTF-16, contadas antes de remover espaços das extremidades, o cabeçalho de uma URL de dados ou os espaços internos aceitos. Um símbolo Base64 comum ocupa uma dessas unidades. O resultado precisa conter pelo menos um byte e não pode superar 12582912 bytes, equivalentes a 12 MiB. Esses limites definem a entrada e a saída aceitas; não garantem que a aba use apenas essa quantidade de memória.
Uma sequência sem cabeçalho com 16777216 símbolos válidos pode representar o limite completo de 12 MiB de saída. Cabeçalhos e quebras de linha consomem parte da mesma cota de entrada e podem tornar esse conteúdo grande demais. Uma edição acima do limite é rejeitada por inteiro: a entrada anterior permanece, o download antigo é removido e aparece um erro. A ferramenta não aceita apenas o começo truncado dessa edição. Obtenha os dados originais ou use um fluxo adequado a arquivos maiores, em vez de cortar o texto codificado para fazê-lo caber.
| Limite | Valor exato | Consequência prática |
|---|---|---|
| Entrada bruta | 16777216 unidades de código UTF-16 | Cabeçalhos e espaços contam antes da limpeza. |
| Saída decodificada | 12582912 bytes, ou 12 MiB | A saída também precisa conter pelo menos um byte. |
| Campo do nome | 120 unidades de código UTF-16 | O nome longo tem um limite separado do conteúdo. |
| Trabalho simultâneo | Um valor codificado no espaço de trabalho | Não há fila em lote nem histórico de trabalhos salvos. |
Limpe o texto copiado sem alterar os dados
Os espaços em branco nas extremidades são removidos. Dentro do conteúdo, o decodificador retira apenas espaço ASCII, tabulação, avanço de linha, retorno de carro e avanço de página. Isso permite Base64 distribuído em linhas comuns, mas uma tabulação vertical ou um espaço inseparável interno não é ignorado. Assim, um valor copiado de um documento formatado pode falhar por causa de um caractere difícil de perceber.
Quando possível, obtenha uma cópia em texto simples da fonte original. Não substitua todo caractere desconhecido nem apague pontuação ao acaso até o erro desaparecer: mais e barra podem fazer parte dos dados Base64. Acrescentar sinais de igual também não recupera símbolos ausentes. O erro genérico não aponta o caractere exato; confira de forma ordenada o cabeçalho, o alfabeto, o preenchimento e o tamanho bruto.
Escolha um nome que descreva os bytes recuperados
O nome padrão é decoded.bin. A ferramenta substitui determinados caracteres de controle e sinais inadequados para caminhos por sublinhados, remove certos pontos e espaços nas extremidades, elimina espaços externos e limita o nome a 120 unidades de código UTF-16. Se nada restar, usa decoded.bin. O nome exibido é uma sugestão para o download; regras do navegador e do sistema operacional ainda podem alterar o nome salvo.
A extensão ajuda outros programas a reconhecer o conteúdo; ela não o modifica. Chamar bytes quaisquer de photo.png não cria um PNG. Da mesma forma, .pdf não repara um documento danificado e .zip não compacta nada. Se o formato for desconhecido, peça essa informação a quem enviou o conteúdo. A ferramenta não detecta formatos nem verifica se o tipo de mídia de uma URL de dados corresponde aos bytes.
O download mantém o conteúdo binário
O conjunto de bytes decodificado se torna um Blob com o tipo de conteúdo application/octet-stream. Esse tipo binário é usado mesmo quando a URL de dados declara text/plain ou o nome termina em .png. Baixar arquivo cria uma URL de objeto temporária e solicita ao navegador que baixe o conteúdo com o nome proposto. O espaço de trabalho não oferece prévia e não abre nem executa o arquivo recuperado.
Cada clique no botão de download agenda a revogação da respectiva URL de objeto após 60000 milissegundos. Essa limpeza não apaga um arquivo já salvo nem remove o resultado decodificado da página. Enquanto o resultado estiver disponível, você pode clicar em Baixar arquivo novamente. O navegador pode perguntar onde salvar ou seguir suas configurações de download; ver um resultado na página não confirma que o salvamento foi concluído.
MDN: construtor BlobMDN: URL.createObjectURL()MDN: HTMLAnchorElement.download
Saiba quais alterações mantêm o resultado
Alterar a entrada Base64 remove o resultado anterior e qualquer erro antigo de validação. Uma edição grande demais é a exceção à aceitação do novo texto: a entrada anterior permanece, o resultado antigo é removido e um erro aparece. Clicar em Decodificar arquivo também limpa o resultado antes de validar. Se houver uma falha, o arquivo anterior não fica disponível como se correspondesse à nova entrada.
Alterar Nome do arquivo depois de uma decodificação bem-sucedida mantém os bytes e atualiza o nome sugerido para o download. Não é necessário decodificar novamente só para renomear. O processamento é síncrono e não oferece porcentagem de progresso nem botão Cancelar. Não há histórico de trabalhos salvos; guarde o valor original ou um download verificado antes de recarregar ou sair da página.
Diferencie erros de codificação de problemas no arquivo
Um erro de validação significa que a entrada não passou por uma das verificações da ferramenta, não necessariamente que o arquivo original está danificado. Primeiro confirme que copiou o valor inteiro, em vez de um endereço, campo entre aspas ou linha de log. Depois confira o tamanho, os espaços não aceitos, a mistura de alfabetos e o preenchimento. Se não conseguir conferir o valor com a origem, solicite uma nova cópia em vez de fazer alterações por tentativa.
A decodificação pode funcionar e ainda produzir um arquivo incompleto ou inutilizável. A perda de grupos inteiros de símbolos Base64 pode deixar uma sequência sintaticamente válida; os bytes também podem já representar conteúdo danificado, criptografado ou incompatível. Compare a contagem exibida com um tamanho esperado informado separadamente. Se o remetente fornecer um hash por um canal confiável, uma ferramenta de hash separada pode ajudar na comparação; este espaço não calcula nem valida um hash.
| Sintoma | Possível motivo | Próximo passo útil |
|---|---|---|
| Erro genérico de validação | Entrada grande demais, forma ou símbolos incompatíveis, ou preenchimento incorreto | Confira o valor bruto original e as regras de entrada. |
| O arquivo baixa, mas não abre | Extensão incorreta, bytes incompletos, conteúdo criptografado ou formato incompatível | Confirme o formato original e o tamanho esperado com o remetente. |
| O arquivo renomeado continua sem funcionar | Renomear não alterou os bytes | Use um conversor de formato real somente depois de identificar o tipo original. |
| O botão Baixar arquivo sumiu após uma edição | O resultado antigo foi removido | Valide novamente a entrada desejada antes de baixar. |
Processamento local não comprova a confiabilidade do conteúdo
A validação, a decodificação e a preparação do download acontecem na aba atual do navegador. O fluxo implementado não envia o Base64 colado nem o arquivo recuperado a um servidor de decodificação. O carregamento do site ainda envolve os recursos normais da página, e a análise de uso do site pode fazer outras solicitações. Essa descrição do processamento não promete ausência total de tráfego de rede nem disponibilidade permanente sem conexão.
Base64 é uma codificação reversível, não criptografia nem assinatura digital. Decodificar não autentica o remetente, não procura malware nem determina se é adequado abrir o arquivo. Use conteúdo de uma fonte confiável e faça as verificações habituais do seu fluxo de trabalho. O processamento local também não garante a eliminação segura da memória do navegador nem a exclusão dos arquivos já salvos.
Perguntas frequentes
Como salvo Base64 como arquivo?
Cole o valor completo, escolha um nome e clique em Decodificar arquivo. Confira a quantidade de bytes e selecione Baixar arquivo. Decodificar e salvar são ações separadas.
Posso usar Base64 seguro para URLs ou sem preenchimento?
Sim, desde que o valor siga as regras aceitas. As formas padrão e segura para URLs são permitidas com preenchimento correto ou sem preenchimento. A mistura de símbolos exclusivos, grupos finais inválidos e bits de preenchimento não nulos é rejeitada.
Uma URL de dados escolhe o tipo do arquivo baixado?
Não. O cabeçalho Base64 aceito é removido e seu tipo de mídia é ignorado. O Blob usa application/octet-stream, e você escolhe o nome. A ferramenta não verifica o formato do arquivo.
Qual é o tamanho máximo da entrada?
São 16777216 unidades de código UTF-16 antes da limpeza, incluindo cabeçalho e espaços. A saída decodificada precisa ser não vazia e ter no máximo 12582912 bytes, ou 12 MiB.
O que acontece se eu colar texto demais?
A edição acima do limite é rejeitada, a entrada anterior permanece e um erro aparece. O download antigo é removido. A ferramenta não mantém silenciosamente apenas o começo truncado da edição.
Quais espaços podem aparecer dentro do Base64?
Espaço ASCII, tabulação, avanço de linha, retorno de carro e avanço de página são removidos do conteúdo. Outros espaços internos, como o inseparável ou a tabulação vertical, são rejeitados. Os espaços das extremidades são removidos separadamente.
Por que Zh== é rejeitado quando outro decodificador o aceita?
Ele contém bits não utilizados com valor diferente de zero. Esta ferramenta exige bits canônicos após a normalização; Zg== é a representação com preenchimento aceita para o byte da letra f.
Trocar .bin por .png converte o arquivo?
Não. A extensão só altera o nome proposto. Use uma extensão compatível com os bytes originais; a ferramenta não cria outro formato de imagem ou documento.
Posso renomear o resultado sem decodificar novamente?
Sim. Alterar o nome preserva os bytes decodificados e atualiza o nome sugerido para o download. Alterar a entrada Base64 remove o resultado anterior.
Uma decodificação bem-sucedida ainda pode gerar um arquivo com problema?
Sim. Base64 válido pode representar conteúdo incompleto, danificado, criptografado ou incompatível. Quando houver, compare um tamanho esperado fornecido separadamente ou um hash confiável; este espaço não verifica a integridade do arquivo.
Minha entrada e os bytes decodificados são enviados a um servidor?
O decodificador implementado trabalha com eles na aba do navegador, sem etapa de envio. A página ainda pode carregar recursos e fazer solicitações normais do site; decodificação local não significa que o site inteiro dispense a rede.
O arquivo desaparece depois de sessenta segundos?
Não. A limpeza da URL de objeto temporária criada para um download é agendada para depois de sessenta segundos. Isso não apaga o arquivo salvo nem expira o resultado decodificado mantido na página; outro clique pode criar uma nova URL de objeto.