convertImageToBase64

یک فایل تصویر را به رشتهٔ کدشده با Base64 تبدیل می‌کند.

API

convertImageToBase64

بازگشت

آرگومان توضیح نوع
Promise<convertImageToBase64Return> Promise‌ای که با شیء نتیجه برآورده می‌شود Promise

convertImageToBase64Return

ویژگی توضیح نوع
success اینکه کار گرفت یا نه boolean
data دادهٔ Base64 string | ArrayBuffer | null
message پیام خطا string

پارامترها

پارامتر توضیح نوع پیش‌فرض
file شیء فایل تصویر File الزامی

نمونه

کاربرد پایه

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);
        // مستقیم برای src یک img به کار می‌آید
        document.getElementById('preview').src = result.data;
      }
    } catch (error) {
      console.error('تبدیل شکست خورد:', error);
    }
  }
});

پیش‌نمایش پیش از بارگذاری

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('تبدیل تصویر شکست خورد');
}

مدیریت خطا

import { convertImageToBase64 } from 'ranuts';

try {
  const result = await convertImageToBase64(file);
  if (!result.success) {
    console.error('خطا:', result.message);
  }
} catch (error) {
  console.error('استثنا:', error);
}

یادداشت‌ها

  1. ناهمگام است: Promise برمی‌گرداند، پس با await یا .then() رسیدگی کنید.

  2. گونهٔ فایل: هر قالب تصویری که مرورگر بشناسد (JPEG، PNG، GIF، WebP و مانند آن).

  3. قالب داده: dataی بازگشتی یک Data URL کامل است (data:image/jpeg;base64,...) و همان‌طور در ویژگی src تگ img جا می‌افتد.

  4. مدیریت خطا: اگر تبدیل شکست بخورد Promise رد می‌شود؛ آن را بگیرید.

  5. کاربرد: معمولاً برای پیش‌نمایش تصویر، پردازش پیش از بارگذاری و ذخیرهٔ محلی به کار می‌رود.