Node.js Tutorial فصل ۲ — هسته Node (ماژول‌ها) درس آموزشی

کار با فایل‌ها و پوشه‌ها (fs)

ماژول fs قلب کار با دیسک است: خواندن، نوشتن، پوشه‌سازی و حذف. سه سبک دارید: sync (بلاک‌کننده)، callback قدیمی و Promise مدرن با fs/promises — در کد جدید همیشه fs/promises را انتخاب کنید چون با async/await تمیز کار می‌کند و حلقه رویداد را بلاک نمی‌کند.

مراحل قدم‌به‌قدم

  1. ۱

    خواندن فایل

    const fs = require('fs/promises'); const text = await fs.readFile('data.txt', 'utf-8'); بدون utf-8 خروجی Buffer خام است و console.log آن بایت‌ها را نشان می‌دهد — اشتباه کلاسیک تازه‌کارها.

  2. ۲

    نوشتن و افزودن

    await fs.writeFile('log.txt', 'متن جدید'); محتوا را بازنویسی می‌کند. برای چسباندن به انتهای فایل از fs.appendFile استفاده کنید؛ برای پوشه‌سازی خودکار از گزینه { recursive: true } در mkdir.

  3. ۳

    چک وجود و ساختار

    fs.access یا try/catch دور readFile برای تشخیص نبودن فایل؛ fs.readdir برای لیست پوشه و fs.stat برای اطلاعات (اندازه، تاریخ، فایل بودن یا پوشه).

  4. ۴

    کپی، تغییر نام و حذف

    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

editor.html
در حال آماده‌سازی زمین بازی…

کد را ویرایش کنید و «اجرای کد» را بزنید — خروجی واقعی مرورگر همین‌جا رندر می‌شود؛ مثل آزمایشگاه w3schools.

پرسش و پاسخ این درس (۰)

هنوز دیدگاهی ثبت نشده؛ اولین نفر باشید!

دیدگاه خود را بنویسید

کپچا

دیدگاه شما پس از تأیید مدیر نمایش داده می‌شود.