Express: المسارات والطلبات
الخادم الذي كتبته بوحدة http يعمل، لكنه يصبح فوضى مع كثرة المسارات. Express إطار صغير ومنتشر جدًا ينظّم ذلك: مسارات واضحة، وقراءة سهلة للبيانات، ومعالجة موحّدة للأخطاء.
المسارات ومعاملات الرابط
npm install express
import express from "express";
const app = express();
app.use(express.json()); // لقراءة الجسم بصيغة JSON
let tasks = [
{ id: 1, title: "تصميم الصفحة الرئيسية", done: false },
{ id: 2, title: "ربط نموذج التواصل", done: true },
];
app.get("/api/tasks", (req, res) => {
res.json(tasks);
});
app.get("/api/tasks/:id", (req, res) => {
const task = tasks.find((t) => t.id === Number(req.params.id));
if (!task) return res.status(404).json({ error: "المهمة غير موجودة" });
res.json(task);
});
app.listen(process.env.PORT ?? 3000);
:id جزء متغير من الرابط يصلك في req.params.id، نصًا دائمًا، لذلك نحوّله بـ Number. والمعاملات بعد ? تصلك في req.query، مثل req.query.done للرابط /api/tasks?done=true.
قراءة جسم الطلب
app.post("/api/tasks", (req, res) => {
const title = String(req.body?.title ?? "").trim();
if (title.length < 3) {
return res.status(400).json({ error: "العنوان قصير جدًا" });
}
const task = { id: Date.now(), title, done: false };
tasks.push(task);
res.status(201).json(task);
});
app.put("/api/tasks/:id", (req, res) => {
const task = tasks.find((t) => t.id === Number(req.params.id));
if (!task) return res.status(404).json({ error: "المهمة غير موجودة" });
if (typeof req.body?.done === "boolean") task.done = req.body.done;
res.json(task);
});
app.delete("/api/tasks/:id", (req, res) => {
tasks = tasks.filter((t) => t.id !== Number(req.params.id));
res.status(204).end();
});
لا تثق أبدًا بما يصلك: تحقق من وجود كل حقل ونوعه وطوله قبل استعماله.
الوسائط (middleware)
الوسيط دالة تمر بها الطلبات قبل أن تصل إلى المسار. express.json() نفسه وسيط. ويمكنك كتابة وسيطك:
app.use((req, res, next) => {
const start = Date.now();
res.on("finish", () => {
console.log(`${req.method} ${req.url} ${res.statusCode} ${Date.now() - start}ms`);
});
next(); // مرّر الطلب إلى ما بعده
});
بهذا يُسجَّل كل طلب مع مدته. وبنفس الفكرة ستكتب لاحقًا وسيطًا يتحقق من تسجيل الدخول.
معالجة الأخطاء بشكل موحّد
في آخر الملف، بعد كل المسارات:
// أي مسار لم يطابق ما سبق
app.use((req, res) => {
res.status(404).json({ error: "المسار غير موجود" });
});
// أي خطأ غير متوقع
app.use((err, req, res, next) => {
console.error(err);
res.status(500).json({ error: "حدث خطأ في الخادم" });
});
وسيط الأخطاء يأخذ أربعة معاملات، ويلتقط كل خطأ يُرمى في المسارات. وفي Express 5 يلتقط أيضًا أخطاء الدوال async تلقائيًا. لاحظ أن المستخدم يرى رسالة عامة، أما التفاصيل فتبقى في سجلات الخادم؛ لا تكشف للزائر بنية نظامك.
مهمتك
أكمل الـ API بالعمليات الخمس على المهام، وجرّب كلًا منها بـ Thunder Client. أضف تصفية بالرابط (/api/tasks?done=true)، وأعد كود 400 مع رسالة واضحة لكل بيانات غير صحيحة.