آموزش نود جی اس (Node.js): از مفاهیم پایه تا ساخت اولین وب‌سرور واقعی

نود جی اس امکان اجرای کد جاوااسکریپت را خارج از مرورگر فراهم می‌کند تا بتوانید به مرورگر محدود نمانید و برنامه‌های سمت سرور بنویسید. در این آموزش عملی، معماری نود جی اس، نحوه ساخت وب‌سرور، کار با فریم‌ورک Express و اصول مدیریت حافظه و خطایابی در محیط پروژه‌های واقعی را یاد می‌گیرید.

نود جی اس چیست و چگونه کار می‌کند؟

پاسخ کوتاه: نود جی اس یک محیط اجرای (Runtime Environment) متن‌باز و فرامتقاطع برای جاوااسکریپت است. نود جی اس بر روی موتور V8 کروم اجرا می‌شود و کدهای جاوااسکریپت را مستقیماً به کد ماشین تبدیل می‌کند تا بدون نیاز به مرورگر، روی سرور اجرا شوند.

برخلاف مدل‌های سنتی مانند PHP یا ASP.NET که برای هر درخواست کاربر یک ترد (Thread) جدید اختصاص می‌دهند، Node.js از معماری تک‌تردی (Single-Threaded) همراه با حلقه رویداد (Event Loop) استفاده می‌کند. این ویژگی باعث می‌شود سرور بتواند هزاران اتصال هم‌زمان را با مصرف بسیا کم حافظه RAM مدیریت کند.

اگر با مرورگرها کار کرده باشید، حتماً با تکه‌کدهای جاوااسکریپت برای مدیریت DOM آشنا هستید. اما در نود جی اس اشیایی مثل window یا document وجود ندارند؛ در عوض شما به ماژول‌های سیستم‌عامل، فایل‌سیستم (FS)، شبکه (Net) و مسیرها (Path) دسترسی مستقیم دارید.

مقایسه نود جی اس با سایر محیط‌های اجرا

برای انتخاب درست ابزار توسعه، باید بدانید Node.js در مقایسه با سایر زبان‌ها و پلتفرم‌های سمت سرور چه جایگاهی دارد:

مراحل نصب و راه‌اندازی محیط توسعه

برای شروع کار با نود جی اس، مراحل زیر را گام‌به‌گام انجام دهید:

1. دانلود نسخه LTS: به سایت رسمی Node.js مراجعه کنید و نسخه LTS (پشتیبانی بلندمدت) را دانلود نمایید. این نسخه بالاترین میزان پایداری را در پروژه‌های واقعی دارد.
2. نصب بسته: فایل دانلود شده را باز کرده و با فشردن Next مراحل نصب استاندارد را طی کنید. حتماً گزینه افزودن به PATH را فعال بگذارید.
3. بررسی نصب در ترمینال: ترمینال (CMD یا Terminal) را باز کنید و دستورات زیر را وارد کنید تا از نصب موفقیت‌آمیز مطمئن شوید:

   node -v
   npm -v

4. ساخت پوشه پروژه: یک پوشه جدید در سیستم بسازید، وارد آن شوید و دستور راه‌اندازی پروژه را اجرا کنید:

   mkdir my-node-app
   cd my-node-app
   npm init -y

دستور npm init -y یک فایل به نام package.json ایجاد می‌کند که مشخصات پروژه و کتابخانه‌های نصب‌شده را مدیریت خواهد کرد. اگر علاوه بر نود جی اس قصد ساخت برنامه‌های دسکتاپ یا یادگیری ابزارهای گرافیکی پایتون را دارید، مطالعه آموزش pyqt5 می‌تواند دید خوبی به شما درباره تفاوت برنامه‌نویسی دسکتاپ و وب بدهد.

ساخت اولین وب‌سرور با Node.js

پاسخ کوتاه: برای ساخت وب‌سرور در نود جی اس بدون نیاز به ابزار جانبی، کافی است ماژول داخلی http را فراخوانی کرده و متد createServer را روی یک پورت مشخص اجرا کنید.

یک فایل به نام server.js در پوشه پروژه بسازید و کدهای زیر را درون آن بنویسید:

const http = require('http');

const PORT = 3000;

const server = http.createServer((req, res) => {
    res.writeHead(200, { 'Content-Type': 'text/plain; charset=utf-8' });
    res.end('سلام! این اولین وب‌سرور من با نود جی اس است.');
});

server.listen(PORT, () => {
    console.log(`سرور روی آدرس http://localhost:${PORT} فعال شد.`);
});

حالا برای اجرای سرور در ترمینال دستور زیر را بزنید:

node server.js

مرورگر را باز کنید و به آدرس http://localhost:3000 بروید. پیام شما روی صفحه نمایش داده می‌شود!

توسعه وب API با فریم‌ورک Express.js

ماژول داخلی http برای پروژه‌های بزرگ کمی پیچیده است زیرا مسیریابی (Routing) و مدیریت پارامترها در آن سخت می‌شود. برای این کار از فریم‌ورک محبوب Express.js استفاده می‌کنیم.

ابتدا Express را نصب کنید:

npm install express

کد زیر یک API ساده استاندارد برای دریافت و ارسال اطلاعات JSON ایجاد می‌کند:

const express = require('express');
const app = express();

app.use(express.json());

// مسير GET اصلی
app.get('/api/users', (req, res) => {
    res.json([
        { id: 1, name: 'علی' },
        { id: 2, name: 'سارا' }
    ]);
});

// مسیر POST برای دریافت داده
app.post('/api/users', (req, res) => {
    const newUser = req.body;
    res.status(201).json({ message: 'کاربر ایجاد شد', user: newUser });
});

app.listen(5000, () => {
    console.log('API روی پورت 5000 آماده پاسخگویی است.');
});

اگر علاوه بر توسعه سمت سرور، نیازمند یادگیری ابزارهای تحلیل یا کدهای سمت سرور دیگر هستید، بررسی مجموعه‌های کدهای آماده پایتون در کنار جاوااسکریپت، دید کامل‌تری برای طراحی سیستم‌های توزیع‌شده به شما می‌دهد.

مدیریت عملیات غیرهمزمان و معماری Event Loop

قلب تپنده نود جی اس، نحوه مدیریت رفتارهای غیرهمزمان (Asynchronous) است. هنگام خواندن فایل از دیسک یا خواندن داده از دیتابیس، نود جی اس منتظر نمی‌ماند و بلافاصله به سراغ اجرای درخواست بعدی می‌رود.

استفاده از Async/Await و مدیریت خطا

بهترین و تمیزترین روش برای خواندن اطلاعات غیرهمزمان، بهره‌گیری از الگوی async/await به همراه ساختار try...catch است:

const fs = require('fs').promises;

async function readFileData() {
    try {
        const data = await fs.readFile('data.txt', 'utf-8');
        console.log('محتوای فایل:', data);
    } catch (error) {
        console.error('خطا در خواندن فایل:', error.message);
    }
}

readFileData();

• هرگز از توابع Sync مانند readFileSync در کدهای اصلی وب‌سرور استفاده نکنید؛ زیرا Event Loop را کاملاً قفل (Block) می‌کند.
• پرومیس‌های رد شده (Unhandled Rejections) را حتماً مدیریت کنید تا برنامه‌تان ناگهانی کرش نکند.

عیب‌یابی سریع و رفع خطاهای رایج

هنگام توسعه برنامه با نود جی اس، ممکن است با چند خطای متداول مواجه شوید. جدول عیب‌یابی زیر راه‌حل سریع آنهاست:

پرسش‌های متداول

برای مشاهده پروژه‌ها و برنامه‌های بیشتر در زمینه کدنویسی، می‌توانید از مجموعه اسنیپت‌های کاربردی سایت بازدید کنید.