型付きMiddlewareとError Handler

ようこそ

ミドルウェアのシグネチャ

import { RequestHandler } from 'express';
const authMiddleware: RequestHandler = (req, res, next) => {
  if (!req.headers.authorization) return res.status(401).json({});
  next();
};

NextFunction

import { Request, Response, NextFunction } from 'express';
function logger(req: Request, res: Response, next: NextFunction): void {
  console.log(req.method, req.path);
  next();
}

エラーハンドラーのシグネチャ

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

カスタムエラークラス

class AppError extends Error {
  constructor(public message: string, public status: number = 500) {
    super(message);
  }
}

非同期ミドルウェアラッパー

function asyncHandler(fn: RequestHandler): RequestHandler {
  return (req, res, next) => Promise.resolve(fn(req, res, next)).catch(next);
}

ユーザーを付加する認証ミドルウェア

const authenticate: RequestHandler = async (req, res, next) => {
  const user = await verifyToken(req.headers.authorization);
  req.user = user; // requires module augmentation
  next();
};

Zodを使った検証ミドルウェア

function validate<T>(schema: ZodSchema<T>): RequestHandler {
  return (req, res, next) => {
    const result = schema.safeParse(req.body);
    if (!result.success) return res.status(400).json(result.error);
    req.body = result.data;
    next();
  };
}

Routerレベルのミドルウェア

router.use('/admin', authenticate, authorize('admin'));
router.get('/admin/users', asyncHandler(listUsers));

ロギングミドルウェア

const requestLogger: RequestHandler = (req, _res, next) => {
  console.log(`${req.method} ${req.path}`);
  next();
};

グローバルエラーハンドラーの登録

app.use(requestLogger);
app.use('/api', apiRouter);
app.use(errorHandler); // must be last

クイックチェック

まとめ