Express のミドルウェア設計パターンは、フロントエンド開発でも使われる機会が増えてきた。本稿では実際のプロジェクトを出発点に、その本質的な仕組みとベストプラクティスを深掘りする。

基本的な使い方

全体のサンプルコードを示す。

const fs = require('fs')
const { Transform, pipeline } = require('stream')
const { promisify } = require('util')
const pipelineAsync = promisify(pipeline)

const csvToJson = new Transform({
  transform(chunk, encoding, callback) {
    const lines = chunk.toString().split('\n')
    const headers = lines[0].split(',')
    for (let i = 1; i < lines.length; i++) {
      if (!lines[i].trim()) continue
      const values = lines[i].split(',')
      const obj = {}
      headers.forEach((h, idx) => obj[h.trim()] = values[idx]?.trim())
      this.push(JSON.stringify(obj) + '\n')
    }
    callback()
  }
})

エッジケース（境界条件）の処理には気をつけること。本番環境ではこれが極めて重要になる。

応用的な使い方

肝心なのは、仕組みの根本を理解することだ。

const express = require('express')
const app = express()

app.use(express.json())

class AppError extends Error {
  constructor(status, message) {
    super(message); this.statusCode = status
  }
}

const asyncHandler = (fn) => (req, res, next) =>
  Promise.resolve(fn(req, res, next)).catch(next)

app.get('/api/users/:id', asyncHandler(async (req, res) => {
  const user = await User.findById(req.params.id)
  if (!user) throw new AppError(404, '用户不存在')
  res.json({ data: user })
}))

パフォーマンスチューニングは場面に合わせて考えるべきで、すべてのケースで過剰に最適化する必要はない。

実践事例

次のようなアプローチで改善できる。

const fs = require('fs')
const { Transform, pipeline } = require('stream')
const { promisify } = require('util')
const pipelineAsync = promisify(pipeline)

const csvToJson = new Transform({
  transform(chunk, encoding, callback) {
    const lines = chunk.toString().split('\n')
    const headers = lines[0].split(',')
    for (let i = 1; i < lines.length; i++) {
      if (!lines[i].trim()) continue
      const values = lines[i].split(',')
      const obj = {}
      headers.forEach((h, idx) => obj[h.trim()] = values[idx]?.trim())
      this.push(JSON.stringify(obj) + '\n')
    }
    callback()
  }
})

このアプローチは本番環境で半年以上安定稼働しており、実際に検証済みだ。

パフォーマンス最適化

基本的な実装の流れから見ていこう。

const express = require('express')
const app = express()

app.use(express.json())

class AppError extends Error {
  constructor(status, message) {
    super(message); this.statusCode = status
  }
}

const asyncHandler = (fn) => (req, res, next) =>
  Promise.resolve(fn(req, res, next)).catch(next)

app.get('/api/users/:id', asyncHandler(async (req, res) => {
  const user = await User.findById(req.params.id)
  if (!user) throw new AppError(404, '用户不存在')
  res.json({ data: user })
}))

ここでは基本的な使い方を示した。実際のプロジェクトでは、エラーハンドリングやエッジケース（境界条件）も考慮する必要がある。

よくある落とし穴

これをベースに、さらに最適化を進められる。

const fs = require('fs')
const { Transform, pipeline } = require('stream')
const { promisify } = require('util')
const pipelineAsync = promisify(pipeline)

const csvToJson = new Transform({
  transform(chunk, encoding, callback) {
    const lines = chunk.toString().split('\n')
    const headers = lines[0].split(',')
    for (let i = 1; i < lines.length; i++) {
      if (!lines[i].trim()) continue
      const values = lines[i].split(',')
      const obj = {}
      headers.forEach((h, idx) => obj[h.trim()] = values[idx]?.trim())
      this.push(JSON.stringify(obj) + '\n')
    }
    callback()
  }
})

このパターンは大規模なプロジェクトで非常に実用的で、保守コストを大きく下げられる。

まとめ

• コード例はあくまで参考であり、実際の業務の場面に合わせて調整すること
• Express のミドルウェア設計パターンは銀の弾丸ではなく、プロジェクトの規模と技術スタックに応じて選ぶ必要がある
• API を丸暗記するより、根底の原理を理解するほうが大切だ