تحديد أنواع طلبات Express واستجاباته

ترحيب

تثبيت الأنواع

npm install express
npm install --save-dev @types/express

أنواع المسارات الأساسية

import { Request, Response } from 'express';
app.get('/users', (req: Request, res: Response) => {
  res.json({ users: [] });
});

معلمات المسارات محدّدة النوع

interface Params { id: string; }
app.get('/users/:id', (req: Request<Params>, res: Response) => {
  const { id } = req.params;
});

Body الطلب محدّد النوع

interface CreateUser { name: string; email: string; }
app.post('/users', (req: Request<{}, {}, CreateUser>, res: Response) => {
  const { name, email } = req.body;
});

معلمات Query محدّدة النوع

interface Query { page?: string; limit?: string; }
app.get('/users', (req: Request<{}, {}, {}, Query>, res: Response) => {
  const page = parseInt(req.query.page ?? '1');
});

توسيع Request

declare global {
  namespace Express {
    interface Request { user?: User; }
  }
}

Response محدّد النوع

app.get('/me', (req: Request, res: Response<User>) => {
  res.json(req.user!); // response body must be User
});

أنواع معالج الأخطاء

import { ErrorRequestHandler } from 'express';
const errHandler: ErrorRequestHandler = (err, req, res, next) => {
  res.status(500).json({ error: err.message });
};

استخدام Router مع الأنواع

import { Router } from 'express';
const router = Router();
router.get('/:id', (req: Request<{ id: string }>, res) => {});

Middleware للتحقق

function parseBody<T>(schema: ZodSchema<T>) {
  return (req: Request, res: Response, next: NextFunction) => {
    req.body = schema.parse(req.body);
    next();
  };
}

تحقق سريع

مراجعة