Node.js وExpress: خادم بـ JavaScript

طريقان إلى نفس الفكرة

قبل أن تبدأ

الفكرة الجوهرية

1حلقة الأحداث: انتظار بلا توقّف

Node يبدأ العمليات البطيئة (ملف، شبكة) ويكمل غيرها، ثم يعود حين تجهز. هذا المثال يُظهر الترتيب: الكود المتزامن أولًا، ثم الوعود، ثم المؤقّتات.

console.log("1 start");
setTimeout(() => console.log("4 timer"), 0);
Promise.resolve().then(() => console.log("3 promise"));
console.log("2 end of script");

2المسارات وRouter

app.get("/orders", handler) يربط فعلًا ومسارًا بدالة. req.params للمقاطع (/orders/:id)، وreq.query لما بعد ?، وreq.body للجسم بعد express.json().

3الوسائط: سلسلة بالترتيب

الوسيط دالة (req, res, next). تقرأ أو تعدّل الطلب ثم تنادي next()، أو ترد وتنهي السلسلة. التسجيل والمصادقة وتحليل JSON كلها وسائط.

// a tiny middleware chain without Express, to see the idea run
function run(chain, req) {
  let i = 0;
  const next = (err) => {
    const fn = chain[i++];
    if (!fn) return;
    if (err) return fn.length === 4 ? fn(err, req, next) : next(err);
    if (fn.length === 4) return next();
    try { fn(req, next); } catch (e) { next(e); }
  };
  next();
}

run([
  (req, next) => { console.log("log:", req.method, req.path); next(); },
  (req, next) => { if (!req.user) throw new Error("401 not logged in"); next(); },
  (req, next) => console.log("handler: list orders"),
  (err, req, next) => console.log("error handler ->", err.message),
], { method: "GET", path: "/orders", user: null });

4التحقّق ومعالج الأخطاء

لا تثق بأي مدخل: تحقّق من النوع والطول والقيم المسموحة وارجع 400 برسالة واضحة. واجعل آخر وسيط معالج أخطاء يسجّل الخطأ ويرد 500 دون كشف التفاصيل للمستخدم.

مثال محلول

واجهة طلبات مقهى: عرض، إنشاء بتحقّق، جلب بالمعرّف مع 404، ومعالج أخطاء أخير. احفظه server.js وشغّله بـ node server.js.

import express from "express";

const app = express();
app.use(express.json());
app.use((req, res, next) => {
  const start = Date.now();
  res.on("finish", () => console.log(req.method, req.path, res.statusCode, Date.now() - start + "ms"));
  next();
});

const MENU = new Set(["latte", "mocha", "v60"]);
const orders = [];

app.get("/orders", (req, res) => res.json(orders));

app.post("/orders", (req, res) => {
  const { item, cups } = req.body ?? {};
  if (!MENU.has(item)) return res.status(400).json({ error: `item must be one of ${[...MENU]}` });
  if (!Number.isInteger(cups) || cups < 1 || cups > 10) return res.status(400).json({ error: "cups must be 1-10" });
  const order = { id: orders.length + 1, item, cups };
  orders.push(order);
  res.status(201).location(`/orders/${order.id}`).json(order);
});

app.get("/orders/:id", (req, res) => {
  const order = orders.find((o) => o.id === Number(req.params.id));
  if (!order) return res.status(404).json({ error: "no such order" });
  res.json(order);
});

app.use((err, req, res, next) => {          // four arguments: the error handler
  console.error(err);
  res.status(500).json({ error: "something went wrong" });
});

app.listen(3000, () => console.log("http://localhost:3000"));

curl -s localhost:3000/orders -H 'content-type: application/json' -d '{"item":"latte","cups":2}'
curl -s localhost:3000/orders/1
curl -s -o /dev/null -w "%{http_code}\n" localhost:3000/orders/99

خرافة مقابل حقيقة

اختبر فهمك

بطاقات مراجعة سريعة

تحقق من فهمك