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

ماژول‌ها: require و import

هر فایل در Node یک ماژول است؛ چیزی که خارج شود باید export شود و برای استفاده باید import. دو سبک داریم: CommonJS قدیمی (require/module.exports) و ES Modules مدرن (import/export). پروژه‌های جدید مُد مدرن دارند اما در آموزش‌ها و کدهای وردپرس‌محور هنوز CommonJS زیاد می‌بینید — باید هر دو را بخوانید بلد باشید.

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

  1. ۱

    CommonJS

    در فایل math.js: module.exports = { sum }; و در فایل دیگر: const { sum } = require('./math'); مسیر نسبی را فراموش نکنید؛ require بدون ./ فقط از node_modules می‌خواند.

  2. ۲

    ES Modules

    در math.mjs یا با نوع پروژه module: export function sum(a, b) { … } و import { sum } from './math.js'. دقت: در ESM پسوند فایل در import الزامی است و package.json باید "type": "module" داشته باشد.

  3. ۳

    Global built-inها

    چیزهایی که بدون import هست‌اند: console، setTimeout، process (اطلاعات و متغیرهای محیطی)، __dirname (مسیر فعلی فایل در CJS). در ESM از import { fileURLToPath } یا import.meta.url استفاده می‌کنید.

  4. ۴

    مبارزه با مسیرها

    path.join(__dirname, 'data', 'users.json') مسیر سازگار با همه سیستم‌عامل می‌سازد؛ چسباندن رشته‌ها با / خطای ویندوز می‌سازد. __dirname فقط در CommonJS است؛ در ESM با import.meta.url می‌سازید.

نکات مهم

  • ◆ در یک پروژه، سبک ماژول را قاطی نکنید؛ package.json تصمیم‌گیرنده است.
  • ◆ مسیرها همیشه با path.join بسازید نه چسباندن رشته.
  • ◆ خطای Cannot find module یعنی مسیر نسبی اشتباه یا پکیج نصب نیست.

کد یا مسیر نمونه

// math.js (CommonJS)
function sum(a, b) { return a + b; }
function multiply(a, b) { return a * b; }
module.exports = { sum, multiply };

// app.js
const { sum, multiply } = require("./math");
const path = require("path");
console.log(sum(3, 4), multiply(3, 4));
console.log("مسیر داده:", path.join(__dirname, "data", "users.json"));

/* نسخه ESM — package.json با "type":"module"
   export function sum(a, b) { return a + b; }
   import { sum } from "./math.js";
*/

اجرای زنده کد JavaScript

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

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

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

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

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

کپچا

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