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

빠른 확인

복습