Código

Base64 para arquivo: decodifique os bytes e salve o conteúdo correto

·

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.

Base64 para arquivo

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 representa bytes; o significado vem do conteúdo
Base64Conteúdo recuperadoQuantidade de bytes
Zg==A letra f1
Zm8=As letras fo2
Zm9vAs letras foo3
AP8=Bytes binários 00 FF em hexadecimal2

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.

RFC 4648: codificações de dados Base16, Base32 e Base64

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.

A URL de dados envolve o conteúdo, mas não o converte
Forma da entradaComportamento da ferramentaO que conferir
SGVsbG8=Decodifica o conteúdo isoladoUse o valor codificado completo.
data:text/plain;base64,SGVsbG8=Remove o cabeçalho aceito e decodificaO cabeçalho não escolhe um nome nem converte os bytes.
data:text/plain,HelloRejeita a forma sem Base64Procure o decodificador adequado a essa URL de dados.
data:text/plain;base64,SGVsbG8%3DRejeita o escape percentual no conteúdoVerifique se há uma camada externa de codificação de URL a remover.

RFC 2397: esquema de URL dataMDN: construtor Blob

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.

Conte a entrada antes de remover cabeçalhos e espaços
LimiteValor exatoConsequência prática
Entrada bruta16777216 unidades de código UTF-16Cabeçalhos e espaços contam antes da limpeza.
Saída decodificada12582912 bytes, ou 12 MiBA saída também precisa conter pelo menos um byte.
Campo do nome120 unidades de código UTF-16O nome longo tem um limite separado do conteúdo.
Trabalho simultâneoUm valor codificado no espaço de trabalhoNão há fila em lote nem histórico de trabalhos salvos.

RFC 4648: codificações de dados Base16, Base32 e Base64

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.

RFC 4648: codificações de dados Base16, Base32 e Base64

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.

MDN: HTMLAnchorElement.downloadMDN: construtor Blob

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.

MDN: construtor BlobMDN: HTMLAnchorElement.download

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.

Diferencie erros de codificação de problemas no arquivo
SintomaPossível motivoPróximo passo útil
Erro genérico de validaçãoEntrada grande demais, forma ou símbolos incompatíveis, ou preenchimento incorretoConfira o valor bruto original e as regras de entrada.
O arquivo baixa, mas não abreExtensão incorreta, bytes incompletos, conteúdo criptografado ou formato incompatívelConfirme o formato original e o tamanho esperado com o remetente.
O arquivo renomeado continua sem funcionarRenomear não alterou os bytesUse um conversor de formato real somente depois de identificar o tipo original.
O botão Baixar arquivo sumiu após uma ediçãoO resultado antigo foi removidoValide novamente a entrada desejada antes de baixar.

RFC 4648: codificações de dados Base16, Base32 e Base64

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.

RFC 4648: codificações de dados Base16, Base32 e Base64

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.

Fontes e leitura complementar

Coloque em prática.

Guias relacionados