فصل ۱ — آشنایی و شروع
Node.js چیست و چه چیزی میسازد؟فصل ۲ — هسته Node (ماژولها)
ماژولها: require و import کار با فایلها و پوشهها (fs)فصل ۳ — سرور وب و HTTP
ساخت اولین سرور با ماژول httpفصل ۴ — npm و پروژه واقعی
npm و مدیریت پکیجها متغیرهای محیطی و مدیریت تنظیماتفصل ۵ — Express و REST
Express: روتر، middleware و پاسخها حلقه رویداد، async و مصرف API از داخل Nodeپروژه عملی پایان دوره
پروژه پایانی ۱ — API کامل مدیریت کارها با ذخیره فایل پروژه پایانی ۲ — وبسایت خبری کوچک با Express و قالب HTMLپروژه پایانی ۱ — API کامل مدیریت کارها با ذخیره فایل
پروژه پایانی اول: یک REST API کامل برای مدیریت کارها با Express که داده را در فایل JSON ذخیره میکند، اعتبارسنجی ورودی دارد، مسیرهای CRUD کامل و مدیریت خطای مرکزی — دقیقاً پایهای که بعداً دیتابیس زیرش مینشیند.
راهحل قدمبهقدم پروژه
-
۱
هدف پروژه
ساخت API با CRUD کامل (فهرست، جزئیات، ساخت، ویرایش، حذف) روی مسیر /todos با ذخیرهسازی فایل و خطاهای استاندارد HTTP.
-
۲
الزامات و موارد موردنیاز
Node.js و npm نصب؛ پکیج express؛ آشنایی با درسهای fs و Express؛ تست با curl یا Postman.
-
۳
قدم ۱ — لایه داده بسازید
فایل store.js با توابع async: listTodos، getTodo، createTodo، updateTodo، deleteTodo که روی فایل data/todos.json با fs/promises کار میکنند. هر تابع فایل را میخواند، تغییر میدهد و مینویسد — ساده اما واقعی.
-
۴
قدم ۲ — مدل و id یکتا
شکل هر Todo: { id, title, done, createdAt }. id با شمارنده یا crypto.randomUUID بسازید. createdAt با new Date().toISOString() ثبت شود تا بعداً مرتبسازی ممکن باشد.
-
۵
قدم ۳ — مسیرهای CRUD
در app.js مسیرها را وصل کنید: GET /todos و GET /todos/:id و POST /todos و PUT /todos/:id و DELETE /todos/:id. POST با express.json بدنه میگیرد و عنوان خالی را با 422 رد میکند.
-
۶
قدم ۴ — کدهای وضعیت درست
ساخت موفق 201، یافتنشده 404، ورودی نامعتبر 422، خطای سرور 500. پاسخ خطا همیشه { error: 'پیام فارسی' } باشد تا کلاینت ساده نمایش دهد.
-
۷
قدم ۵ — مدیریت خطای مرکزی
middleware چهار آرگومانی آخر زنجیره بگذارید که خطاها را لاگ و با 500 جواب دهد. store را در try/catch بپیچید تا خرابی فایل، سرور را نیندازد.
نکات مهم
- ◆ قبل از خواندن راهحل، خودتان حداقل ۳۰ دقیقه تلاش کنید؛ یادگیری واقعی در همین تلاش اتفاق میافتد.
- ◆ راهحل را بعد از دیدن، عمداً تغییر دهید و دوباره اجرا کنید تا با هر خط آن آشنا شوید.
- ◆ اگر جایی گیر کردید، فقط بخش مشکل را جستجو کنید، نه کل پروژه را — دامنه جستجوی کوچک یادگیری را عمیقتر میکند.
کد کامل راهحل پروژه
// store.js
const fs = require("fs/promises");
const FILE = "data/todos.json";
async function readAll() {
try {
return JSON.parse(await fs.readFile(FILE, "utf-8"));
} catch {
return [];
}
}
async function writeAll(items) {
await fs.mkdir("data", { recursive: true });
await fs.writeFile(FILE, JSON.stringify(items, null, 2));
}
async function listTodos() { return readAll(); }
async function getTodo(id) {
return (await readAll()).find((t) => t.id === id) || null;
}
async function createTodo(title) {
const items = await readAll();
const todo = { id: Date.now(), title, done: false, createdAt: new Date().toISOString() };
items.push(todo);
await writeAll(items);
return todo;
}
async function updateTodo(id, patch) {
const items = await readAll();
const idx = items.findIndex((t) => t.id === id);
if (idx === -1) return null;
items[idx] = { ...items[idx], ...patch };
await writeAll(items);
return items[idx];
}
async function deleteTodo(id) {
const items = await readAll();
const next = items.filter((t) => t.id !== id);
if (next.length === items.length) return false;
await writeAll(next);
return true;
}
module.exports = { listTodos, getTodo, createTodo, updateTodo, deleteTodo };
// app.js
const express = require("express");
const store = require("./store");
const app = express();
app.use(express.json());
app.get("/todos", async (req, res) => res.json(await store.listTodos()));
app.get("/todos/:id", async (req, res) => {
const todo = await store.getTodo(Number(req.params.id));
if (!todo) return res.status(404).json({ error: "کار یافت نشد" });
res.json(todo);
});
app.post("/todos", async (req, res) => {
const title = String(req.body?.title || "").trim();
if (title.length < 2) return res.status(422).json({ error: "عنوان حداقل ۲ نویسه است" });
res.status(201).json(await store.createTodo(title));
});
app.put("/todos/:id", async (req, res) => {
const todo = await store.updateTodo(Number(req.params.id), {
...(req.body.title ? { title: String(req.body.title).trim() } : {}),
...(typeof req.body.done === "boolean" ? { done: req.body.done } : {}),
});
if (!todo) return res.status(404).json({ error: "کار یافت نشد" });
res.json(todo);
});
app.delete("/todos/:id", async (req, res) => {
const ok = await store.deleteTodo(Number(req.params.id));
if (!ok) return res.status(404).json({ error: "کار یافت نشد" });
res.status(204).end();
});
app.use((err, req, res, next) => {
console.error(err);
res.status(500).json({ error: "خطای داخلی سرور" });
});
app.listen(3000, () => console.log("API آماده روی :3000"));
اجرای زنده کد JavaScript
کد را ویرایش کنید و «اجرای کد» را بزنید — خروجی واقعی مرورگر همینجا رندر میشود؛ مثل آزمایشگاه w3schools.
خروجی مورد انتظار
تست با curl:
curl localhost:3000/todos → []
curl -X POST -H 'Content-Type: application/json' -d '{"title":"خرید نان"}' localhost:3000/todos → کار ساختهشده با id و createdAt
curl localhost:3000/todos → لیست با یک کار
curl -X PUT -d '{"done":true}' .../todos/<id> → کار با done:true
curl -X DELETE .../todos/<id> → 204
curl .../todos/999 → {"error":"کار یافت نشد"}
چالش اضافه (اختیاری)
فیلتر ?done=true و جستجوی ?q= عنوان را اضافه کنید و داده را در localStorage کلاینت هم آینه کنید.
پرسش و پاسخ این درس (۰)
هنوز دیدگاهی ثبت نشده؛ اولین نفر باشید!