کلاس FileReader برای خواندن محتوای فایل

کلاس FileReader
کلاس FileReader در نسخه‌های جدید Appsan برای مدیریت عملیات خواندن فایل‌ها به صورت متنی، باینری و Data URL استفاده می‌شود. این کلاس برای خواندن محتوای یک Blob و فایل‌ها در محیط جاوااسکریپت طراحی شده است. در اینجا به معرفی متدهای این کلاس و نحوه استفاده از آن‌ها پرداخته می‌شود.
1. متدها و ویژگی‌ها
1.1 readAsText
این متد برای خواندن محتوای یک Blob یا فایل به صورت متن استفاده می‌شود.

ورودی‌ها:

blob (نوع: JSObject): شیء Blob که می‌خواهید محتوای آن را به صورت متن بخوانید.

encoding (اختیاری، نوع: String): نوع کدگذاری که به صورت پیش‌فرض "utf-8" است.

خروجی: این متد خروجی خاصی ندارد اما پس از خواندن موفقیت‌آمیز، مقدار result در شیء FileReader به متن خوانده شده تنظیم می‌شود. همچنین اگر تابع onload تعریف شده باشد، پس از تکمیل خواندن، این تابع فراخوانی می‌شود.

1.2 readAsArrayBuffer
این متد برای خواندن محتوای یک Blob یا فایل به صورت باینری (آرایه‌ای از بایت‌ها) استفاده می‌شود.

ورودی‌ها:

blob (نوع: JSObject): شیء Blob که می‌خواهید محتوای آن را به صورت آرایه بایت بخوانید.

خروجی: مانند readAsText، این متد خروجی خاصی ندارد اما مقدار result در شیء FileReader به آرایه بایت‌های خوانده شده تنظیم می‌شود. تابع onload نیز در صورت تعریف، پس از تکمیل خواندن فراخوانی می‌شود.

1.3 readAsDataURL
این متد برای خواندن محتوای یک Blob یا فایل به صورت Data URL استفاده می‌شود. این متد در نسخه‌های بعدی Appsan ارائه خواهد شد.

ورودی‌ها:

blob (نوع: JSObject): شیء Blob که می‌خواهید محتوای آن را به صورت Data URL بخوانید.

encoding (اختیاری، نوع: String): نوع کدگذاری که به صورت پیش‌فرض "utf-8" است.

خروجی: این متد نیز خروجی خاصی ندارد اما مقدار result در شیء FileReader به Data URL تنظیم می‌شود و تابع onload پس از تکمیل عملیات فراخوانی می‌شود.

2. نمونه کدها
در زیر چند نمونه کد از استفاده کلاس FileReader آورده شده است.
<script id="script-upload">
 var selectedFile;

 function readAsText() {
 if (!selectedFile) {
 Appsan.runAction("snackbar/'No file selected.'");
 return;
 }

 const reader = new FileReader();
 reader.onload = function() {
 console.log(reader.result);
 Appsan.setProperty('result', 'text', reader.result);
 }
 reader.readAsText(selectedFile);
 }

 function readAsArrayBuffer() {
 if (!selectedFile) {
 Appsan.runAction("snackbar/'No file selected.'");
 return;
 }

 const reader = new FileReader();
 reader.onload = function() {
 console.log(reader.result);
 const ab = reader.result;
 const uint8Array = new Uint8Array(ab);

 const byteString = Array.from(uint8Array).map(byte => byte.toString(16).padStart(2, '0')).join(' ');

 console.log(byteString);
 Appsan.setProperty('result', 'text', byteString);
 }
 reader.readAsArrayBuffer(selectedFile);
 }

 function readAsDataURL() {
 if (!selectedFile) {
 Appsan.runAction("snackbar/'No file selected.'");
 return;
 }

 const reader = new FileReader();
 reader.onload = function() {
 console.log(reader.result);
 Appsan.setProperty('result', 'text', reader.result);
 }
 reader.readAsDataURL(selectedFile);
 }
</script>

3. نکات مهم

در نسخه‌های آینده، متد readAsDataURL به طور کامل در دسترس خواهد بود.
توجه داشته باشید که متدها در FileReader به صورت ناهمگام (asynchronous) اجرا می‌شوند و نتیجه عملیات پس از اتمام در ویژگی result ذخیره می‌شود.