استخدام Async / Await لقراءة الملفات الخارجية بأسلوب نظيف

أهلاً بكم أيها المبرمجون! اليوم سنتعلم كيفية استخدام ميزات JavaScript الحديثة Async/Await لقراءة الملفات الخارجية بأسلوب نظيف وقابل للقراءة في بيئة Node.js.

سنتناول مثالاً عملياً لقراءة محتوى ملف نصي خطوة بخطوة، مع التركيز على الكفاءة ووضوح الكود.

1. تهيئة المشروع واستيراد وحدة fs.promises

قبل البدء، تأكد من وجود ملف نصي باسم example.txt في نفس مسار السكربت الذي ستنفذه. سنقوم أولاً باستيراد الوحدة اللازمة لقراءة الملفات.

تُعد fs.promises هي الواجهة الموصى بها للتعامل مع نظام الملفات في Node.js باستخدام الـ Promises، مما يجعلها متوافقة تماماً مع async/await.

// استيراد وحدة نظام الملفات (File System) في Node.js
// <code dir="ltr" style="background:#f3f4f6; color:#0056b3; padding:2px 6px; border-radius:4px; font-family:monospace; direction:ltr !important; display:inline-block;">.promises</code> يوفر واجهة مبنية على الـ Promises، وهي مثالية للاستخدام مع async/await
const fs = require('fs').promises;

هذا السطر يقوم باستيراد واجهة الـ Promises الخاصة بوحدة fs، والتي تحتوي على دوال مثل readFile التي تعيد Promise.

2. كتابة دالة غير متزامنة (async) لقراءة محتوى الملف

الآن سنقوم بإنشاء دالة async. هذه الدالة ستسمح لنا باستخدام الكلمة المفتاحية await داخلها لجعل العمليات غير المتزامنة تبدو وكأنها متزامنة.

// دالة غير متزامنة لقراءة محتوى ملف معين
async function readFileContent(filePath) {
    try {
        // استخدام 'await' لانتظار انتهاء عملية قراءة الملف
        // 'utf8' تحدد ترميز الملف لضمان قراءة النص بشكل صحيح
        const data = await fs.readFile(filePath, 'utf8');
        console.log('تم قراءة الملف بنجاح:');
        console.log(data); // طباعة محتوى الملف المقروء
        return data; // إرجاع محتوى الملف
    } catch (error) {
        // معالجة الأخطاء التي قد تحدث أثناء قراءة الملف (مثل عدم وجود الملف)
        console.error(<code dir="ltr" style="background:#f3f4f6; color:#0056b3; padding:2px 6px; border-radius:4px; font-family:monospace; direction:ltr !important; display:inline-block;">حدث خطأ أثناء قراءة الملف ${filePath}:</code>, error.message);
        throw error; // إعادة رمي الخطأ للسماح بمعالجته في مستوى أعلى إذا لزم الأمر
    }
}

في هذه الدالة، نستخدم await fs.readFile(filePath, 'utf8'). الكلمة المفتاحية await توقف تنفيذ الدالة مؤقتاً حتى يتم حل الـ Promise الذي تعيده fs.readFile، إما بنجاح (ثم تُرجع البيانات) أو بفشل (ثم تُرمى استثناء). نستخدم try...catch لمعالجة أي أخطاء محتملة.

3. استدعاء الدالة الرئيسية وتنفيذها

لجعل السكربت يعمل، نحتاج إلى دالة رئيسية (أو نقطة دخول) تقوم باستدعاء دالة قراءة الملف. يمكننا أيضاً جعل هذه الدالة الرئيسية async لاستخدام await عند استدعاء readFileContent.

// دالة رئيسية غير متزامنة لتنظيم سير العمل
async function main() {
    const filePath = 'example.txt'; // تحديد مسار الملف المراد قراءته
    console.log(<code dir="ltr" style="background:#f3f4f6; color:#0056b3; padding:2px 6px; border-radius:4px; font-family:monospace; direction:ltr !important; display:inline-block;">بدء قراءة الملف: ${filePath}</code>);
    try {
        // استدعاء دالة قراءة الملف وانتظار اكتمالها
        await readFileContent(filePath);
        console.log('انتهى السكربت من عملية القراءة.');
    } catch (error) {
        // معالجة الأخطاء التي تم رميها من دالة readFileContent
        console.error('فشل السكربت في القراءة بسبب خطأ:', error.message);
    }
}

// استدعاء الدالة الرئيسية لبدء تنفيذ السكربت
main();

هنا، الدالة main تستدعي readFileContent وتنتظر نتيجتها. هذا النمط يجعل تسلسل العمليات غير المتزامنة واضحاً وسهل التتبع.

الكود النهائي الكامل

لنفترض أن لديك ملف example.txt بالمحتوى التالي:

مرحباً بك في عالم Async/Await!
هذا هو محتوى ملف example.txt.
نتمنى لك تجربة برمجة ممتعة.

ثم قم بإنشاء ملف JavaScript (مثلاً read_file.js) بالمحتوى التالي:

// read_file.js

// 1. استيراد وحدة نظام الملفات (File System) في Node.js
// <code dir="ltr" style="background:#f3f4f6; color:#0056b3; padding:2px 6px; border-radius:4px; font-family:monospace; direction:ltr !important; display:inline-block;">.promises</code> يوفر واجهة مبنية على الـ Promises، وهي مثالية للاستخدام مع async/await
const fs = require('fs').promises;

// 2. دالة غير متزامنة لقراءة محتوى ملف معين
async function readFileContent(filePath) {
    try {
        // استخدام 'await' لانتظار انتهاء عملية قراءة الملف
        // 'utf8' تحدد ترميز الملف لضمان قراءة النص بشكل صحيح
        const data = await fs.readFile(filePath, 'utf8');
        console.log('تم قراءة الملف بنجاح:');
        console.log(data); // طباعة محتوى الملف المقروء
        return data; // إرجاع محتوى الملف
    } catch (error) {
        // معالجة الأخطاء التي قد تحدث أثناء قراءة الملف (مثل عدم وجود الملف)
        console.error(<code dir="ltr" style="background:#f3f4f6; color:#0056b3; padding:2px 6px; border-radius:4px; font-family:monospace; direction:ltr !important; display:inline-block;">حدث خطأ أثناء قراءة الملف ${filePath}:</code>, error.message);
        throw error; // إعادة رمي الخطأ للسماح بمعالجته في مستوى أعلى إذا لزم الأمر
    }
}

// 3. دالة رئيسية غير متزامنة لتنظيم سير العمل
async function main() {
    const filePath = 'example.txt'; // تحديد مسار الملف المراد قراءته
    console.log(<code dir="ltr" style="background:#f3f4f6; color:#0056b3; padding:2px 6px; border-radius:4px; font-family:monospace; direction:ltr !important; display:inline-block;">بدء قراءة الملف: ${filePath}</code>);
    try {
        // استدعاء دالة قراءة الملف وانتظار اكتمالها
        await readFileContent(filePath);
        console.log('انتهى السكربت من عملية القراءة.');
    } catch (error) {
        // معالجة الأخطاء التي تم رميها من دالة readFileContent
        console.error('فشل السكربت في القراءة بسبب خطأ:', error.message);
    }
}

// استدعاء الدالة الرئيسية لبدء تنفيذ السكربت
main();

النتيجة المتوقعة

عند تشغيل السكربت (باستخدام node read_file.js) مع وجود ملف example.txt يحتوي على النص المذكور أعلاه، ستكون النتيجة في الطرفية كالتالي:

بدء قراءة الملف: example.txt
تم قراءة الملف بنجاح:
مرحباً بك في عالم Async/Await!
هذا هو محتوى ملف example.txt.
نتمنى لك تجربة برمجة ممتعة.
انتهى السكربت من عملية القراءة.

إذا لم يكن الملف example.txt موجوداً، ستظهر رسالة خطأ توضح أن الملف غير موجود، مثل:

بدء قراءة الملف: example.txt
حدث خطأ أثناء قراءة الملف example.txt: ENOENT: no such file or directory, open 'example.txt'
فشل السكربت في القراءة بسبب خطأ: ENOENT: no such file or directory, open 'example.txt'

بهذا نكون قد أكملنا درسنا حول استخدام Async/Await لقراءة الملفات الخارجية بأسلوب نظيف وفعال. نأمل أن يكون هذا الدرس قد أضاف لكم قيمة!

← السابقالفهرسالتالي →