Como converter dados de imagem para Base64 e criar um data URI

Para que serve

Esta ferramenta converte dados de imagem fornecidos em Base64 numa representação Base64 dos bytes originais. Também pode criar um data URI com tipo MIME, útil quando pretende inserir a imagem diretamente num contexto que aceite esse formato. O ponto de partida é texto Base64 de uma imagem, não um URL remoto, uma imagem para editar ou dados arbitrários. [Não é necessário incluir uma extensão de ficheiro no texto, mas os dados têm de corresponder a uma imagem que possa ser aberta.]

Como converter os dados da imagem

Prepare os dados da imagem em Base64. Se o campo de dados ficar vazio, o processamento é rejeitado, por isso confirme que inseriu o conteúdo antes de continuar.
Introduza o texto no campo de dados de imagem. A ferramenta descodifica o Base64 e tenta abrir os bytes como uma imagem. O conteúdo deve ser fornecido como dados Base64 da imagem; não substitua este valor por um endereço de imagem.
Decida se pretende incluir um data URI. Esta opção está ativada por predefinição. Mantenha-a ativada se precisar de uma cadeia com o tipo MIME incorporado; desative-a quando quiser apenas a representação Base64, sem uma cadeia data URI adicional.
Execute o processamento e verifique o resultado. Quando é bem-sucedido, a ferramenta cria a representação Base64 dos bytes originais. Com a opção de data URI ativada, cria também um data URI com tipo MIME. Se a opção estiver desativada, não é produzida uma cadeia data URI.
Confirme o formato indicado antes de utilizar o resultado. PNG, JPEG, WEBP, GIF e BMP recebem os tipos MIME de imagem correspondentes. Se não for possível detetar o formato, é utilizado PNG e image/png. Se o formato detetado não for reconhecido, o formato devolvido mantém o valor detetado, mas o tipo MIME recua para image/png.

Como ler o resultado

Um resultado bem-sucedido deve conter a representação Base64 da imagem original. Quando a inclusão do data URI está ativa, deve também apresentar uma cadeia que combina o tipo MIME com essa representação; quando está desativada, a ausência dessa cadeia é esperada.

Um resultado sem sucesso indica que o processamento não conseguiu concluir a descodificação ou a abertura da imagem, que os dados estavam vazios ou que não havia suporte para descodificar imagens. A fronteira de validação não garante que todo o conteúdo malformado seja rejeitado: a descodificação Base64 não usa validação estrita e a abertura apenas tenta interpretar os bytes como imagem. Por isso, um resultado positivo não deve ser tratado como confirmação de que o ficheiro está livre de corrupção parcial.

A definição de tipo MIME merece atenção nos casos menos comuns. Para formatos reconhecidos, compare o formato e o tipo MIME apresentados. Nos restantes casos, aplique a regra de fallback descrita acima em vez de presumir que o tipo MIME corresponde ao texto do formato.

Exemplo prático

Uma pessoa precisa de preparar os dados Base64 de uma imagem PNG para os inserir num contexto que aceite um data URI.

Forneça os dados Base64 de uma imagem PNG, mantenha a inclusão do data URI ativada e processe a entrada; depois compare o formato indicado com o tipo MIME apresentado.

O resultado bem-sucedido apresenta uma representação Base64 da imagem e, com a opção ativa, um data URI com o tipo MIME correspondente, como image/png para uma imagem PNG reconhecida.

Limitações

A validação não é estrita: conteúdo malformado ou parcialmente corrompido pode não ser rejeitado apenas nesta fase.

Erros comuns

Deixar o campo vazio ou inserir um valor que não corresponde aos dados Base64 da imagem pode causar um resultado sem sucesso. Insira dados Base64 não vazios e confirme que representam bytes que a ferramenta consiga tentar abrir como imagem.

Perguntas frequentes

A ferramenta cria um data URI por defeito?

A opção de data URI está ativada por predefinição. Pode mantê-la ativa para obter a cadeia com tipo MIME ou desativá-la para não produzir essa cadeia.

Posso fornecer um URL de uma imagem?

Não. O campo de entrada aceita dados de imagem em Base64; os factos disponíveis não indicam suporte para URLs remotos.

Que tipo MIME é usado no data URI?

PNG, JPEG, WEBP, GIF e BMP recebem os tipos MIME correspondentes. Quando o formato não é detetado, é usado PNG com image/png; perante um formato detetado mas não reconhecido, o tipo MIME recua para image/png.