Express 5 vs Fastify مقارنة

// Express 5 - معالج مسار غير متزامن + التقاط تلقائي للأخطاء
import express from 'express';

const app = express();
app.use(express.json());

// فئة خطأ بسيطة — لرسالة ذات معنى عند حدود API
class NotFoundError extends Error {
  status = 404;
}

async function getUser(id) {
  const user = await db.users.findById(id);
  if (!user) throw new NotFoundError('User not found');
  return user;
}

// Express 5: إذا رفض المعالج غير المتزامن (reject) أو رمى (throw) يُستدعى next(err) تلقائيًا.
// لا تنسَ إرجاع (return) الـPromise — وإلا قد يبقى الرفض (rejection) غير معالَج.
app.get('/api/users/:id', async (req, res) => {
  const user = await getUser(req.params.id);
  res.json(user);
});

// middleware مركزي للأخطاء — يُضاف في نهاية المكدس العام
app.use((err, req, res, next) => {
  const status = err.status ?? 500;
  res.status(status).json({ error: err.message });
});

app.listen(3000, () => {
  console.log('Express server listening on port 3000');
});

// Fastify 5 - التحقق من المخطط + التسلسل التلقائي
import Fastify from 'fastify';

const fastify = Fastify({ logger: true });

// مخطط الاستجابة: يُنتج fast-json-stringify دالة تسلسل
// مُجمَّعة من هذا المخطط — أسرع من JSON.stringify العام.
const userSchema = {
  type: 'object',
  properties: {
    id: { type: 'string' },
    name: { type: 'string' },
    email: { type: 'string' },
  },
  required: ['id', 'name', 'email'],
};

const getUserOpts = {
  schema: {
    params: {
      type: 'object',
      properties: { id: { type: 'string' } },
      required: ['id'],
    },
    response: {
      200: userSchema,
    },
  },
};

// Encapsulation: الـhook/decorator المسجّل داخل هذه الإضافة (plugin)
// يتسرب فقط إلى المسارات (routes) داخل هذا السياق (context).
fastify.register(async function userRoutes(instance) {
  instance.get('/api/users/:id', getUserOpts, async (request, reply) => {
    const user = await db.users.findById(request.params.id);
    if (!user) {
      return reply.code(404).send({ error: 'User not found' });
    }
    request.log.info({ userId: user.id }, 'user fetched');
    return user;
  });
});

fastify.setErrorHandler((error, request, reply) => {
  reply.status(error.statusCode ?? 500).send({ error: error.message });
});

await fastify.listen({ port: 3000 });