فصل ۱ — آشنایی و شروع
Node.js چیست و چه چیزی میسازد؟فصل ۲ — هسته Node (ماژولها)
ماژولها: require و import کار با فایلها و پوشهها (fs)فصل ۳ — سرور وب و HTTP
ساخت اولین سرور با ماژول httpفصل ۴ — npm و پروژه واقعی
npm و مدیریت پکیجها متغیرهای محیطی و مدیریت تنظیماتفصل ۵ — Express و REST
Express: روتر، middleware و پاسخها حلقه رویداد، async و مصرف API از داخل Nodeپروژه عملی پایان دوره
پروژه پایانی ۱ — API کامل مدیریت کارها با ذخیره فایل پروژه پایانی ۲ — وبسایت خبری کوچک با Express و قالب HTMLکار با فایلها و پوشهها (fs)
ماژول fs قلب کار با دیسک است: خواندن، نوشتن، پوشهسازی و حذف. سه سبک دارید: sync (بلاککننده)، callback قدیمی و Promise مدرن با fs/promises — در کد جدید همیشه fs/promises را انتخاب کنید چون با async/await تمیز کار میکند و حلقه رویداد را بلاک نمیکند.
مراحل قدمبهقدم
-
۱
خواندن فایل
const fs = require('fs/promises'); const text = await fs.readFile('data.txt', 'utf-8'); بدون utf-8 خروجی Buffer خام است و console.log آن بایتها را نشان میدهد — اشتباه کلاسیک تازهکارها.
-
۲
نوشتن و افزودن
await fs.writeFile('log.txt', 'متن جدید'); محتوا را بازنویسی میکند. برای چسباندن به انتهای فایل از fs.appendFile استفاده کنید؛ برای پوشهسازی خودکار از گزینه { recursive: true } در mkdir.
-
۳
چک وجود و ساختار
fs.access یا try/catch دور readFile برای تشخیص نبودن فایل؛ fs.readdir برای لیست پوشه و fs.stat برای اطلاعات (اندازه، تاریخ، فایل بودن یا پوشه).
-
۴
کپی، تغییر نام و حذف
fs.copyFile، fs.rename و fs.unlink (حذف فایل) و fs.rmdir/remove (حذف پوشه). دقت کنید rename برای انتقال بین پوشهها هم کار میکند و unlink روی پوشه خطا میدهد.
نکات مهم
- ◆ در کد جدید همیشه fs/promises با async/await؛ fs.sync فقط در اسکریپتهای راهاندازی.
- ◆ همیشه encoding بدهید وگرنه Buffer میگیرید.
- ◆ حذف فایل برگشتی ندارد — مسیر را قبل از unlink دوباره چک کنید.
کد یا مسیر نمونه
const fs = require("fs/promises");
const path = require("path");
async function main() {
await fs.mkdir("data", { recursive: true });
await fs.writeFile("data/notes.txt", "اولین یادداشت\n");
await fs.appendFile("data/notes.txt", "یادداشت دوم\n");
const content = await fs.readFile("data/notes.txt", "utf-8");
console.log("محتوا:", content.trim());
const files = await fs.readdir("data");
console.log("فایلها:", files);
try {
await fs.readFile("not-exists.txt", "utf-8");
} catch (err) {
console.log("فایل وجود ندارد — طبیعی است");
}
}
main();
/* خروجی مورد انتظار:
محتوا: اولین یادداشت
یادداشت دوم
فایلها: [ 'notes.txt' ]
فایل وجود ندارد — طبیعی است
*/
اجرای زنده کد JavaScript
کد را ویرایش کنید و «اجرای کد» را بزنید — خروجی واقعی مرورگر همینجا رندر میشود؛ مثل آزمایشگاه w3schools.
پرسش و پاسخ این درس (۰)
هنوز دیدگاهی ثبت نشده؛ اولین نفر باشید!