第7章 実践パターン

1. ログ

1.1 console.logの問題点

開発中は`console.log`でデバッグすることが多いが、実務では不十分である。

Table 1. console.logの問題点

1.2 ログレベル

ログには重要度を示す「レベル」がある。

Table 2. ログレベル一覧

1.3 出力レベルの設定

ログには2つの「レベル」の概念がある。

Table 3. 2つのレベル

Fig. 1 フィルタリングの仕組み

設定：ログレベル = INFO（INFO以上を表示）

コードが出力しようとするログ:
[TRACE] ...  → 表示されない（INFO未満）
[DEBUG] ...  → 表示されない（INFO未満）
[INFO]  ...  → 表示される ✓
[WARN]  ...  → 表示される ✓
[ERROR] ...  → 表示される ✓
[FATAL] ...  → 表示される ✓

1.4 環境による切り替え

Table 4. 環境別設定

コードは変えず、設定だけで表示されるログを切り替えられる。

1.5 Node.jsでの実装

const winston = require('winston');

// 環境変数でレベルを切り替え
const level = process.env.LOG_LEVEL || 'info';

const logger = winston.createLogger({
    level: level,
    format: winston.format.combine(
        winston.format.timestamp(),
        winston.format.printf(({ timestamp, level, message }) => {
            return `[${level.toUpperCase()}] ${timestamp} - ${message}`;
        })
    ),
    transports: [
        new winston.transports.Console(),
        new winston.transports.File({ filename: 'app.log' })
    ]
});

// 使用例
logger.debug('詳細情報');    // DEBUGレベル
logger.info('ログイン成功');  // INFOレベル
logger.warn('応答が遅い');    // WARNレベル
logger.error('ログイン失敗'); // ERRORレベル

1.6 Javaのログ設定（参考）

Javaのログ設定は複雑である。歴史的経緯により複数のライブラリが存在する。

Table 5. Javaのログライブラリ

Fig. 2 SLF4Jと実装の関係

SLF4J（インターフェース）
    │
    │ どれか1つを選ぶ
    ↓
┌─────────┬─────────┬─────────┐
│ Logback │ Log4j2  │  JUL    │
│ （実装） │ （実装） │ （実装） │
└─────────┴─────────┴─────────┘

コードはSLF4Jで書き、実装は設定で差し替えられる。

2. デバッグ

2.1 デバッグの方法

Table 6. デバッグ方法の比較

2.2 デバッガの利点

Table 7. デバッガの機能

2.3 デバッガの操作

Table 8. VS Codeのデバッグ操作

2.4 デバッグパネル

Table 9. デバッグパネルの役割

2.5 ステップイン問題の対処

F11（ステップイン）でライブラリの中に入ってしまい迷子になることがある。

Table 10. 対処方法

VS Codeでは`skipFiles`設定でnode_modules等をスキップできる。

// .vscode/launch.json
{
    "skipFiles": [
        "<node_internals>/**",
        "node_modules/**"
    ]
}

3. モック

3.1 モックとは

モックとは「本物の代わりになる偽物」である。テスト時に外部システムへの接続を避けるために使用する。

3.2 なぜモックが必要か

本物のシステムでテストする問題点を整理する。

Table 11. 本物のシステムでテストする問題

3.3 Node.jsでのモック実装

// 本物の関数
async function order(productId, quantity) {
    const response = await fetch('https://api.example.com/order', {
        method: 'POST',
        body: JSON.stringify({ productId, quantity })
    });
    return response.json();
}

// モック（テスト用）
async function orderMock(productId, quantity) {
    return {
        success: true,
        orderId: 'TEST-001',
        message: '発注完了（モック）'
    };
}

// 環境変数で切り替え
const orderFunction = process.env.NODE_ENV === 'test' 
    ? orderMock 
    : order;

3.4 Playwrightでのモック

Playwrightにはネットワークリクエストをモックする機能がある。

// 特定のAPIをモック
await page.route('**/api/order', route => {
    route.fulfill({
        status: 200,
        body: JSON.stringify({
            success: true,
            orderId: 'MOCK-001'
        })
    });
});

// この後のページ操作では、/api/order への通信がモックされる
await page.click('#order-button');

3.5 モックの種類

Table 12. モックの種類

4. 設定管理

4.1 ハードコードの問題

// 悪い例：ハードコード
const dbHost = 'localhost';
const dbPort = 3306;
const apiKey = 'abc123';

Table 13. ハードコードの問題

4.2 環境変数

// 環境変数から読み込む
const dbHost = process.env.DB_HOST;
const dbPort = process.env.DB_PORT;
const apiKey = process.env.API_KEY;

# 開発環境
DB_HOST=localhost DB_PORT=3306 node app.js

# 本番環境
DB_HOST=prod-db.example.com DB_PORT=3306 node app.js

4.3 .envファイル

環境変数をファイルにまとめる方法である。

# .env
DB_HOST=localhost
DB_PORT=3306
API_KEY=abc123

// dotenvパッケージを使用
require('dotenv').config();

const dbHost = process.env.DB_HOST;

重要：.envはGitに含めない（.gitignoreに追加）。代わりに.env.exampleを用意する。

# .env.example（Gitに含める）
DB_HOST=
DB_PORT=
API_KEY=

4.4 設定管理の使い分け

Table 14. 設定方法の使い分け

5. まとめ

Table 15. 第7章のまとめ