كيف تتعامل مع نظام الملفات في Node؟

Question

Accepted Answer

تقرأ وتكتب وحدة **`fs`** المدمجة الملفات والمجلدات. توفر ثلاث أنماط واجهات برمجية — **promises** (الحديثة، الموصى بها)، **callbacks** (غير متزامنة أصلية)، و **sync** (متزامنة) — بحيث يمكنك اختيار النمط المناسب للحالة.

## واجهة البرمجية للـ promise (موصى بها)

```js
import { readFile, writeFile, mkdir, readdir } from "fs/promises";

async function work() {
  const data = await readFile("input.txt", "utf8");     // read (utf8 → string)
  await writeFile("output.txt", "Hello");                // write (overwrites)
  await mkdir("new-dir", { recursive: true });           // create dirs (recursive = mkdir -p)
  const files = await readdir("./");                      // list directory contents
}
```

تعمل واجهة `fs/promises` بشكل نظيف مع async/await — الافتراضي الحديث لعمليات الملفات.

## متغيرات callback و sync

```js
import fs from "fs";

fs.readFile("file.txt", "utf8", (err, data) => { ... }); // async callback
const data = fs.readFileSync("file.txt", "utf8");         // SYNC — blocks the event loop!
```

**تحذير:** تمنع طرق `*Sync` **حلقة الأحداث بالكامل** حتى تنتهي العملية. وهي بخير عند البدء (تحميل الإعدادات مرة واحدة) ولكن يجب تجنبها في معالجات الطلبات — يؤدي الحظر في القراءة إلى تجميد جميع الطلبات المتزامنة.

## العمليات الشائعة

```js
await fs.promises.appendFile("log.txt", "new line
"); // append
await fs.promises.unlink("old.txt");                    // delete a file
await fs.promises.rename("a.txt", "b.txt");             // rename/move
const stats = await fs.promises.stat("file.txt");       // metadata (size, mtime)
const exists = fs.existsSync("file.txt");               // check existence
```

## بالنسبة للملفات الكبيرة: استخدم البث

```js
// ❌ readFile loads the WHOLE file into memory — bad for huge files
const huge = await readFile("10gb.txt"); // could exhaust memory

// ✅ stream it in chunks (constant memory)
fs.createReadStream("10gb.txt").pipe(fs.createWriteStream("copy.txt"));
```

بالنسبة للملفات الكبيرة، تحمل `readFile` كل شيء في الذاكرة مرة واحدة؛ تعالج **البث (streams)** البيانات على دفعات بذاكرة ثابتة.

## لماذا يحتاج الأمر

عمليات الملفات هي قدرة أساسية في Node لتحميل الإعدادات والتسجيل وتحميلات/تنزيلات الملفات والأدوات.

معرفة أنماط واجهات البرمجية الثلاث — والأهم من ذلك، أن **طرق sync تمنع حلقة الأحداث** (تجنبها في الخوادم) وأن **الملفات الكبيرة تحتاج البث** (ليس `readFile`) — ضروري لكتابة كود معالجة الملفات الصحيح والفعال تحت التزامن.

واجهة promise البرمجية مع async/await هي الافتراضي النظيف للاستخدام اليومي.