وحدة fs
تأتي Node.js بوحدات مدمجة، منها fs للتعامل مع الملفات. نستوردها بلا تثبيت:
import fs from "node:fs";
كتابة ملف
import fs from "node:fs";
fs.writeFileSync("note.txt", "مرحبًا أيها الملف!");
console.log("تم إنشاء الملف");
قراءة ملف
import fs from "node:fs";
const content = fs.readFileSync("note.txt", "utf-8");
console.log(content); // مرحبًا أيها الملف!
⚠️
utf-8مهمّ لقراءة النص (وخصوصًا العربي) بشكل صحيح.
متزامن مقابل غير متزامن
| النوع | السلوك |
|---|---|
readFileSync | يوقف التنفيذ حتى ينتهي (متزامن) |
readFile | لا يوقف التنفيذ، يستدعي دالة عند الانتهاء (غير متزامن) |
النسخة غير المتزامنة أفضل للخوادم لأنها لا تُجمّد البرنامج:
import fs from "node:fs";
fs.readFile("note.txt", "utf-8", (err, data) => {
if (err) return console.error(err);
console.log(data);
});
🎯 التالي: البرمجة غير المتزامنة (async/await).