การระบุชนิดคำขอและการตอบกลับของ 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;
});

เนื้อหาคำขอที่มีชนิดกำกับ

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

พารามิเตอร์คำค้นหาที่มีชนิดกำกับ

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; }
  }
}

การตอบกลับที่มีชนิดกำกับ

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) => {});

มิดเดิลแวร์ตรวจสอบความถูกต้อง

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

ตรวจสอบสั้น ๆ

สรุปทบทวน