Типизация запросов и ответов 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();
  };
}

Быстрая проверка

Итоги