Express 5 vs Fastify 比較

// Express 5 - 非同期ルートハンドラー + 自動エラーキャッチ
import express from 'express';

const app = express();
app.use(express.json());

// シンプルなエラークラス — APIの境界で意味のあるメッセージを返すため
class NotFoundError extends Error {
  status = 404;
}

async function getUser(id) {
  const user = await db.users.findById(id);
  if (!user) throw new NotFoundError('User not found');
  return user;
}

// Express 5: 非同期ハンドラーがreject/throwすると、next(err)が自動的に呼ばれる。
// Promiseをreturnし忘れないこと — さもないとrejectionがunhandledのままになる可能性がある。
app.get('/api/users/:id', async (req, res) => {
  const user = await getUser(req.params.id);
  res.json(user);
});

// 中央集権的なエラーミドルウェア — グローバルスタックの最後に追加される
app.use((err, req, res, next) => {
  const status = err.status ?? 500;
  res.status(status).json({ error: err.message });
});

app.listen(3000, () => {
  console.log('Express server listening on port 3000');
});

// Fastify 5 - スキーマバリデーション + 自動シリアライズ
import Fastify from 'fastify';

const fastify = Fastify({ logger: true });

// レスポンススキーマ:fast-json-stringifyがこのスキーマから
// コンパイル済みのシリアライズ関数を生成する — 汎用的なJSON.stringifyより高速。
const userSchema = {
  type: 'object',
  properties: {
    id: { type: 'string' },
    name: { type: 'string' },
    email: { type: 'string' },
  },
  required: ['id', 'name', 'email'],
};

const getUserOpts = {
  schema: {
    params: {
      type: 'object',
      properties: { id: { type: 'string' } },
      required: ['id'],
    },
    response: {
      200: userSchema,
    },
  },
};

// Encapsulation:このプラグイン内で登録されたhook/decoratorは
// このcontext内のルートにのみ及ぶ。
fastify.register(async function userRoutes(instance) {
  instance.get('/api/users/:id', getUserOpts, async (request, reply) => {
    const user = await db.users.findById(request.params.id);
    if (!user) {
      return reply.code(404).send({ error: 'User not found' });
    }
    request.log.info({ userId: user.id }, 'user fetched');
    return user;
  });
});

fastify.setErrorHandler((error, request, reply) => {
  reply.status(error.statusCode ?? 500).send({ error: error.message });
});

await fastify.listen({ port: 3000 });