Node.js Express Server

目次

• 概要
• 使用場面
• クイックスタート
• リファレンスガイド
• ベストプラクティス

概要

業界のベストプラクティスに従い、適切なルーティング、ミドルウェアチェーン、認証メカニズム、データベース統合を備えた堅牢な Express.js アプリケーションを構築します。

使用場面

• Node.js での REST API 構築
• サーバーサイドのリクエスト処理の実装
• 横断的な関心事を扱うミドルウェアチェーンの作成
• 認証と認可の管理
• Node.js からのデータベース接続
• エラーハンドリングとロギングの実装

クイックスタート

最小限の動作例:

const express = require("express");
const app = express();
const PORT = process.env.PORT || 3000;

// Middleware
app.use(express.json());
app.use(express.urlencoded({ extended: true }));

// Routes
app.get("/health", (req, res) => {
  res.json({ status: "OK", timestamp: new Date().toISOString() });
});

// Error handling
app.use((err, req, res, next) => {
  console.error(err.stack);
  res.status(err.status || 500).json({
    error: err.message,
    requestId: req.id,
  });
});

app.listen(PORT, () => {
  console.log(`Server running on port ${PORT}`);
});

リファレンスガイド

references/ ディレクトリ内の詳細な実装:

ガイド	内容
Basic Express Setup	Basic Express Setup
Middleware Chain Implementation	Middleware Chain Implementation
Database Integration (PostgreSQL with Sequelize)	Database Integration (PostgreSQL with Sequelize)
Authentication with JWT	Authentication with JWT
RESTful Routes with CRUD Operations	RESTful Routes with CRUD Operations
Error Handling Middleware	Error Handling Middleware
Environment Configuration	Environment Configuration

ベストプラクティス

✅ すべき事

• 横断的な関心事にはミドルウェアを使用する
• 適切なエラーハンドリングを実装する
• 処理前にвходデータを検証する
• 非同期操作には async/await を使用する
• 保護されたルートに認証を実装する
• 設定には環境変数を使用する
• ロギングとモニタリングを追加する
• 本番環境では HTTPS を使用する
• レート制限を実装する
• ルートハンドラーは焦点を絞り、小規模に保つ

❌ してはいけない事

• エラーをサイレントに処理する
• 機密データをコードに保存する
• ルートで同期的な操作を使用する
• ユーザー入力の検証を忘れる
• ルートハンドラー内で認証を実装する
• コールバック地獄を使用する (Promise/async-await を使用する)
• 本番環境でスタックトレースを公開する
• クライアント側の検証のみを信頼する