Node.js Tutorial فصل ۵ — Express و REST درس آموزشی

Express: روتر، middleware و پاسخ‌ها

Express محبوب‌ترین فریم‌ورک وب Node است: روتر تمیز، middleware زنجیره‌ای و helperهای پاسخ. الگوی ذهنی آن «درخواست از یک زنجیره تابع می‌گذرد؛ هر تابع می‌تواند ادامه دهد یا تمامش کند» است. با چند ده خط، API کامل دارید.

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

  1. ۱

    ساخت و اولین مسیر

    const app = express(); app.get('/', (req, res) => res.send('سلام')); app.listen(3000); مسیرهای GET/POST/PUT/DELETE با همان قالب تعریف می‌شوند و پارامتر مسیر :id در req.params.id می‌آید.

  2. ۲

    middleware — زنجیره پردازش

    تابعی با امضای (req, res, next) که کارهایی مثل لاگ، احراز هویت و پارس بدنه می‌کند و next() می‌زند. app.use(express.json()) بدنه JSON را در req.body می‌گذارد — بدون آن req.body خالی است.

  3. ۳

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

    app.get('/users/:id', handler) و در handler با req.params.id کاربر را پیدا کنید؛ فیلترها مثل /users?city=tehran در req.query.city می‌آیند. ترتیب تعریف مسیرها مهم است؛ مسیر عمومی آخری.

  4. ۴

    پاسخ‌ها و خطاها

    res.json(data) و res.status(404).json({ error: 'یافت نشد' }) قالب استاندارد. برای خطای مرکزی، middleware چهار آرگومانی (err, req, res, next) آخر زنجیره می‌گذارید و همه خطاها به آن می‌رسند.

نکات مهم

  • ◆ app.use(express.json()) را قبل از مسیرهای POST/PUT بگذارید.
  • ◆ ترتیب middleware = ترتیب اجرا؛ لاگ را قبل از مسیرها بگذارید.
  • ◆ در handlerها، هر مسیر فقط یک پاسخ بفرستد؛ دو res.send خطای هدر می‌دهد.

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

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

app.use(express.json());
app.use((req, res, next) => {
  console.log(req.method, req.url);
  next();
});

const users = [{ id: 1, name: "علی" }, { id: 2, name: "سارا" }];

app.get("/users", (req, res) => res.json(users));
app.get("/users/:id", (req, res) => {
  const user = users.find((u) => u.id === Number(req.params.id));
  if (!user) return res.status(404).json({ error: "کاربر یافت نشد" });
  res.json(user);
});
app.post("/users", (req, res) => {
  if (!req.body?.name) return res.status(422).json({ error: "نام الزامی است" });
  const user = { id: users.length + 1, name: req.body.name };
  users.push(user);
  res.status(201).json(user);
});

app.listen(3000, () => console.log("API روی پورت 3000"));

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

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

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

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

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

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

کپچا

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