Node.js アプリケーションのテスト

Volardev 編集部 April 27, 2026

1. Node.js アプリケーションをテストすべき理由

テストはソフトウェア開発において不可欠なプロセスであり、多くのメリットをもたらします。

バグの検出: エラーが本番環境（プロダクション）に到達する前に発見し、修正できます。
コード品質: コードの品質基準を維持し、リグレッション（先祖返り）を防止します。
ドキュメント化: テストはコードがどのように動作すべきかを示す「実行可能なドキュメント」として機能します。
信頼性: コードの変更やリファクタリングを自信を持って行えるようになります。
コラボレーション: チームメンバーがコードの期待される動作を理解するのに役立ちます。
CI/CD: 継続的インテグレーションおよびデプロイメント（CI/CD）パイプラインの実現を可能にします。

2. Node.js におけるテストの種類

2.1 ユニットテスト（単体テスト）

ユニットテストは、関数、メソッド、クラスなどの個々のコンポーネントが、他の部分から切り離された状態で期待通りに動作することを検証します。通常、依存関係にはモック（Mock）を使用します。

例：Node.js の Assert モジュールを使用したユニットテスト

calculator.js

function add(a, b) {
  if (typeof a !== 'number' || typeof b !== 'number') {
    throw new Error('両方の引数は数値である必要があります');
  }
  return a + b;
}

function subtract(a, b) {
  if (typeof a !== 'number' || typeof b !== 'number') {
    throw new Error('両方の引数は数値である必要があります');
  }
  return a - b;
}

module.exports = { add, subtract };

test/calculator.test.js

const assert = require('assert');
const { add, subtract } = require('./calculator');

// add 関数のテスト
assert.strictEqual(add(1, 2), 3, '加算が正しく動作していません');
assert.strictEqual(add(-1, 1), 0, '負の数を含む加算が動作していません');

// subtract 関数のテスト
assert.strictEqual(subtract(5, 2), 3, '減算が正しく動作していません');
assert.strictEqual(subtract(2, 5), -3, '結果が負になる減算が動作していません');

console.log('すべてのテストをパスしました！');

2.2 統合テスト（結合テスト）

統合テストは、データベース操作、API エンドポイント、またはサードパーティサービスとの連携など、複数のコンポーネントが正しく組み合わさって動作するかを検証します。

例：シンプルな API エンドポイントのテスト

app.js

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

app.get('/users', (req, res) => {
  res.json([
    { id: 1, name: 'Alice' },
    { id: 2, name: 'Bob' }
  ]);
});

module.exports = app;

test.js

const assert = require('assert');
const http = require('http');
const app = require('./app');

// サーバーを起動
const server = app.listen(8080);

// API にリクエストを送信
http.get('http://localhost:8080/users', (res) => {
  let data = '';
  
  res.on('data', (chunk) => {
    data += chunk;
  });
  
  res.on('end', () => {
    const users = JSON.parse(data);
    
    // レスポンスを検証
    assert.strictEqual(res.statusCode, 200, 'ステータスコードは 200 であるべきです');
    assert.strictEqual(users.length, 2, '2人のユーザーが返されるべきです');
    assert.strictEqual(users[0].name, 'Alice', '最初のユーザーは Alice であるべきです');
    assert.strictEqual(users[1].name, 'Bob', '2番目のユーザーは Bob であるべきです');
    
    console.log('API テストをパスしました！');
    
    // サーバーを閉じる
    server.close();
  });
}).on('error', (err) => {
  console.error('テスト失敗:', err);
  server.close();
});

2.3 エンドツーエンド（E2E）テスト

エンドツーエンドテストは、実際のユーザーシナリオやインタラクションをシミュレートし、アプリケーションのフロー全体を最初から最後まで検証します。
これらのテストでは通常、Playwright、Cypress、WebdriverIO などのツールを使用してブラウザ操作を自動化します。

注意: E2E テストはセットアップやメンテナンスが複雑ですが、アプリケーションの機能に対して最も網羅的な検証を提供します。

3. テスト駆動開発（TDD）

テスト駆動開発（TDD）は、以下のようなサイクルで進めるソフトウェア開発のアプローチです。

テストを書く: 実装したい機能や改善を定義するテストを作成します。
テストを実行する: 機能がまだ存在しないため、テストは失敗（Red）します。
最小限のコードを書く: テストをパスさせるための最もシンプルなコードを記述します。
リファクタリング: コードの品質基準を満たすように、動作を変えずに整理（Green）します。
繰り返す: 新しい機能や改善ごとにこれを繰り返します。

TDD の例：パスワードバリデーターの開発

password-validator.test.js

// 1. 最初にテストを書く
const assert = require('assert');
const validatePassword = require('./password-validator');

// パスワードの長さのテスト
assert.strictEqual(validatePassword('abc12'), false, '8文字未満のパスワードは拒否すべきです');
assert.strictEqual(validatePassword('abcdef123'), true, '8文字以上のパスワードは許可すべきです');

// 数字が含まれているかのテスト
assert.strictEqual(validatePassword('abcdefgh'), false, '数字を含まないパスワードは拒否すべきです');
assert.strictEqual(validatePassword('abcdefg1'), true, '数字を含むパスワードは許可すべきです');

console.log('すべてのパスワード検証テストをパスしました！');

// 2. テストを実行 - validatePassword が存在しないため失敗します

password-validator.js

// 3. テストをパスさせるための最小限のコードを書く
function validatePassword(password) {
  // 長さをチェック（少なくとも8文字以上）
  if (password.length < 8) {
    return false;
  }
  
  // 少なくとも1つの数字が含まれているかチェック
  if (!/\d/.test(password)) {
    return false;
  }
  
  return true;
}

module.exports = validatePassword;

// 4. テストを再実行 - 今度はパスするはずです
// 5. 必要に応じてリファクタリングし、次の要件に進みます

4. テストのベストプラクティス

4.1 テストしやすいコードを書く

単一責任原則 (SRP): 各関数は1つのことだけを上手に行うようにします。
純粋関数 (Pure Functions): 同じ入力に対して常に同じ出力を返し、サイドエフェクト（副作用）を持たない関数はテストが容易です。
依存性の注入 (Dependency Injection): 依存関係を関数内部で作成するのではなく、外部から渡すようにします。

4.2 テストの構成

関連するテストをグループ化: 関連する機能のテストはまとめて管理します。
分かりやすいテスト名: 何を検証しているのかが明確な名前を付けます。
セットアップとクリーンアップ: テストデータの作成（Setup）と、テスト後の後片付け（Teardown）を適切に行います。

4.3 テストカバレッジ

高いテストカバレッジを目指しつつ、特にクリティカルなパスとエッジケースを優先してください。

ハッピーパス: 期待される正常なフローをテストします。
エッジケース: 境界条件や通常とは異なる入力をテストします。
エラーハンドリング: エラーが正しく処理されることを検証します。

5. モッキング（Mocking）

テスト対象のコードを分離するために、実際の依存関係をテストダブル（替え玉）に置き換えます。

例：データベース接続のモッキング

user-service.js

class UserService {
  constructor(database) {
    this.database = database;
  }
  async getUserById(id) {
    const user = await this.database.findById(id);
    if (!user) {
      throw new Error('ユーザーが見つかりません');
    }
    return user;
  }
}

module.exports = UserService;

user-service.test.js

const assert = require('assert');
const UserService = require('./user-service');

// モックデータベースを作成
const mockDatabase = {
  findById: async (id) => {
    // モックの実装はテストデータを返します
    if (id === 1) {
      return { id: 1, name: 'Alice', email: '[email protected]' };
    }
    return null;
  }
};

async function testUserService() {
  const userService = new UserService(mockDatabase);
  
  // 正常な取得のテスト
  const user = await userService.getUserById(1);
  assert.strictEqual(user.name, 'Alice', '正しいユーザー名を取得すべきです');
  
  // エラーハンドリングのテスト
  try {
    await userService.getUserById(999);
    assert.fail('存在しないユーザーに対してエラーを投げるべきです');
  } catch (error) {
    assert.strictEqual(error.message, 'ユーザーが見つかりません', '正しいエラーメッセージを投げるべきです');
  }
  
  console.log('UserService のテストをパスしました！');
}

testUserService().catch(err => {
  console.error('テスト失敗:', err);
});

6. 非同期コードのテスト

Node.js アプリケーションは非同期操作を頻繁に含みます。テストが非同期コードを適切に処理するように注意してください。

例：非同期関数のテスト

async-service.js

class AsyncService {
  async fetchData() {
    return new Promise((resolve) => {
      setTimeout(() => {
        resolve({ status: 'success', data: [1, 2, 3] });
      }, 100);
    });
  }
  
  async processData() {
    const result = await this.fetchData();
    return result.data.map(num => num * 2);
  }
}

module.exports = AsyncService;

async-service.test.js

const assert = require('assert');
const AsyncService = require('./async-service');

async function testAsyncService() {
  const service = new AsyncService();
  
  // fetchData のテスト
  const fetchResult = await service.fetchData();
  assert.strictEqual(fetchResult.status, 'success', 'success ステータスを返すべきです');
  assert.deepStrictEqual(fetchResult.data, [1, 2, 3], '正しいデータ配列を返すべきです');
  
  // processData のテスト
  const processResult = await service.processData();
  assert.deepStrictEqual(processResult, [2, 4, 6], '配列の各値を2倍にすべきです');
  
  console.log('AsyncService のテストをパスしました！');
}

testAsyncService().catch(err => {
  console.error('テスト失敗:', err);
});

7. 継続的インテグレーション（CI）

継続的インテグレーション（CI）でテストを自動化し、定期的に実行されるようにします。

コードのプッシュ（Push）やプルリクエスト（Pull Request）ごとにテストスイートを実行するように設定します。
テストに失敗したコードのマージを阻止します。
時間の経過とともにテストカバレッジを追跡します。

8. まとめ

テストは信頼性の高い Node.js アプリ構築に不可欠です。
テストの種類（ユニット、統合、E2E）を目的ごとに使い分けましょう。
テスト駆動開発 (TDD) は、コード品質と設計の向上に寄与します。
優れた設計原則に従い、テストしやすいコードを書くことを心がけましょう。
プロジェクトのニーズに合った適切なツールやフレームワークを選択してください。
継続的インテグレーション（CI）によるテストの自動化を行いましょう。

さらに深く学びたい方は、[Node.js CI/CD] チュートリアルをご覧ください。