فصل ۱ — آشنایی و شروع
Node.js چیست و چه چیزی میسازد؟فصل ۲ — هسته Node (ماژولها)
ماژولها: require و import کار با فایلها و پوشهها (fs)فصل ۳ — سرور وب و HTTP
ساخت اولین سرور با ماژول httpفصل ۴ — npm و پروژه واقعی
npm و مدیریت پکیجها متغیرهای محیطی و مدیریت تنظیماتفصل ۵ — Express و REST
Express: روتر، middleware و پاسخها حلقه رویداد، async و مصرف API از داخل Nodeپروژه عملی پایان دوره
پروژه پایانی ۱ — API کامل مدیریت کارها با ذخیره فایل پروژه پایانی ۲ — وبسایت خبری کوچک با Express و قالب HTMLپروژه پایانی ۲ — وبسایت خبری کوچک با Express و قالب HTML
پروژه پایانی دوم: یک وبسایت چندصفحهای با Express که اخبار را از فایل JSON میخواند، صفحه اصلی با لیست، صفحه خبر با slug و فرم تماس با ذخیره پیامها — بدون دیتابیس، قابل دیپلوی روی هر VPS.
راهحل قدمبهقدم پروژه
-
۱
هدف پروژه
ساخت سایت سهصفحهای: خانه (لیست خبر)، خبر تک (بر اساس slug) و تماس (فرم + ذخیره پیام)، با قالببندی سمت سرور.
-
۲
الزامات و موارد موردنیاز
Express نصب؛ فایل data/news.json با ۳ خبر نمونه؛ آشنایی با req.params و req.body.
-
۳
قدم ۱ — داده و بارگذاری
فایل data/news.json با آرایهای از اخبار: { slug, title, body, date }. در start، یک بار بخوانید و در حافظه نگه دارید؛ برای فرم تماس نوشتن به فایل کافی است.
-
۴
قدم ۲ — صفحه اصلی
مسیر GET / لیست خبرها را رندر میکند: عنوان، تاریخ فارسیشده و لینک به /news/:slug. با template literal و map بسازید و XSS را در ذهن داشته باشید (ورودی کاربر مستقیم در HTML نمیرود).
-
۵
قدم ۳ — صفحه خبر تکی
مسیر /news/:slug خبر را با find پیدا میکند؛ نبودش 404 با صفحه خطای فارسی. عنوان در <h1> و body در پاراگرافها (split روی \n).
-
۶
قدم ۴ — فرم تماس
صفحه /contact فرم با نام، ایمیل و پیام دارد؛ POST /contact را express.urlencoded پارس میکند، اعتبارسنجی میکند و پیام را به messages.json اضافه میکند. پاسخ: صفحه تشکر یا redirect با پرچم موفقیت.
-
۷
قدم ۵ — استایل و دیپلوی
یک فایل public/style.css با express.static سرو کنید. برای دیپلوی روی VPS: npm install --omit=dev، اجرا با pm2 و پشت nginx (درس استقرار دوره Docker این را کامل میکند).
نکات مهم
- ◆ قبل از خواندن راهحل، خودتان حداقل ۳۰ دقیقه تلاش کنید؛ یادگیری واقعی در همین تلاش اتفاق میافتد.
- ◆ راهحل را بعد از دیدن، عمداً تغییر دهید و دوباره اجرا کنید تا با هر خط آن آشنا شوید.
- ◆ اگر جایی گیر کردید، فقط بخش مشکل را جستجو کنید، نه کل پروژه را — دامنه جستجوی کوچک یادگیری را عمیقتر میکند.
کد کامل راهحل پروژه
const express = require("express");
const fs = require("fs/promises");
const path = require("path");
const app = express();
app.use(express.urlencoded({ extended: true }));
app.use(express.static("public"));
async function readJson(file, fallback) {
try { return JSON.parse(await fs.readFile(file, "utf-8")); } catch { return fallback; }
}
function page(title, content) {
return `<!doctype html><html lang="fa" dir="rtl"><head><meta charset="utf-8">
<title>${title}</title><link rel="stylesheet" href="/style.css"></head>
<body><header><a href="/">خانه</a> | <a href="/contact">تماس</a></header>
<main>${content}</main></body></html>`;
}
app.get("/", async (req, res) => {
const news = await readJson("data/news.json", []);
const items = news.map((n) =>
`<li><a href="/news/${encodeURIComponent(n.slug)}">${n.title}</a> <small>${n.date}</small></li>`
).join("");
res.send(page("خانه", `<h1>اخبار</h1><ul>${items}</ul>`));
});
app.get("/news/:slug", async (req, res) => {
const news = await readJson("data/news.json", []);
const item = news.find((n) => n.slug === req.params.slug);
if (!item) return res.status(404).send(page("یافت نشد", "<p>خبر پیدا نشد.</p>"));
const paras = item.body.split("\n").map((p) => `<p>${p}</p>`).join("");
res.send(page(item.title, `<h1>${item.title}</h1>${paras}`));
});
app.get("/contact", (req, res) => {
res.send(page("تماس", `<form method="post" action="/contact">
<input name="name" placeholder="نام" required>
<input name="email" type="email" placeholder="ایمیل" required>
<textarea name="message" placeholder="پیام" required></textarea>
<button>ارسال</button></form>`));
});
app.post("/contact", async (req, res) => {
const { name, email, message } = req.body;
if (!name || !email || !message) return res.status(422).send(page("خطا", "<p>همه فیلدها الزامی است.</p>"));
const msgs = await readJson("data/messages.json", []);
msgs.push({ name, email, message, at: new Date().toISOString() });
await fs.writeFile("data/messages.json", JSON.stringify(msgs, null, 2));
res.send(page("تشکر", "<p>پیام شما ثبت شد. ممنون!</p>"));
});
app.listen(3000, () => console.log("سایت روی :3000"));
اجرای زنده کد JavaScript
کد را ویرایش کنید و «اجرای کد» را بزنید — خروجی واقعی مرورگر همینجا رندر میشود؛ مثل آزمایشگاه w3schools.
خروجی مورد انتظار
بازکردن / لیست خبرها را میبیند؛ کلیک روی هر خبر صفحه تکی را میآورد؛ فرم تماس پیام را در data/messages.json ذخیره میکند و صفحه تشکر نشان میدهد. فایل ناموجود slug خطای 404 فارسی میدهد.
چالش اضافه (اختیاری)
RSS feed از همان داده خبر بسازید و paginate لیست خبر را با ?page=2 اضافه کنید.
پرسش و پاسخ این درس (۰)
هنوز دیدگاهی ثبت نشده؛ اولین نفر باشید!