convertImageToBase64

Converte um arquivo de imagem em uma string codificada em Base64.

API

convertImageToBase64

Retorna

Argumento	Descrição	Tipo
`Promise<convertImageToBase64Return>`	Promessa resolvida com o objeto de resultado	`Promise`

convertImageToBase64Return

Propriedade	Descrição	Tipo
`success`	Se deu certo	`boolean`
`data`	Os dados em Base64	`string \| ArrayBuffer \| null`
`message`	Mensagem de erro	`string`

Parâmetros

Parâmetro	Descrição	Tipo	Padrão
`file`	O objeto de arquivo de imagem	`File`	Obrigatório

Exemplo

Uso básico

import { convertImageToBase64 } from 'ranuts';

const fileInput = document.getElementById('fileInput');
fileInput.addEventListener('change', async (e) => {
  const file = e.target.files[0];
  if (file) {
    try {
      const result = await convertImageToBase64(file);
      if (result.success) {
        console.log('Base64:', result.data);
        // Serve direto para o src de uma img
        document.getElementById('preview').src = result.data;
      }
    } catch (error) {
      console.error('A conversão falhou:', error);
    }
  }
});

Pré-visualizar antes de enviar

import { convertImageToBase64 } from 'ranuts';

async function previewImage(file) {
  const result = await convertImageToBase64(file);
  if (result.success) {
    return result.data; // data:image/jpeg;base64,...
  }
  throw new Error('A conversão da imagem falhou');
}

Tratamento de erros

import { convertImageToBase64 } from 'ranuts';

try {
  const result = await convertImageToBase64(file);
  if (!result.success) {
    console.error('Erro:', result.message);
  }
} catch (error) {
  console.error('Exceção:', error);
}

Notas

É assíncrono: devolve uma promessa, então use await ou .then().
Tipos de arquivo: aceita todos os formatos de imagem que o navegador aceitar (JPEG, PNG, GIF, WebP e afins).
Formato dos dados: o data devolvido é uma Data URL completa (data:image/jpeg;base64,...), pronta para o atributo src de uma tag img.
Erros: se a conversão falhar, a promessa é rejeitada; é preciso capturar.
Quando usar: é comum para pré-visualizar imagens, tratá-las antes do envio e guardá-las localmente.