テストデータ生成

目次

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

概要

テストデータ生成は、自動テスト用の現実的で一貫性のある保守しやすいテストデータを作成します。よく設計されたテストデータはテストの脆弱性を低減し、可読性を向上させ、多様なテストシナリオの作成を容易にします。

使用する時機

• 統合テスト用のフィクスチャを作成する場合
• 開発用データベースにフェイクデータを生成する場合
• 複雑な関係を持つテストデータを構築する場合
• テスト用に現実的なユーザー入力を作成する場合
• テストデータベースをシードする場合
• エッジケースと境界値を生成する場合
• 再利用可能なテストデータファクトリを構築する場合

クイックスタート

最小限の動作例：

// tests/factories/userFactory.js
const { faker } = require("@faker-js/faker");

class UserFactory {
  static build(overrides = {}) {
    return {
      id: faker.string.uuid(),
      email: faker.internet.email(),
      firstName: faker.person.firstName(),
      lastName: faker.person.lastName(),
      age: faker.number.int({ min: 18, max: 80 }),
      phone: faker.phone.number(),
      address: {
        street: faker.location.streetAddress(),
        city: faker.location.city(),
        state: faker.location.state(),
        zip: faker.location.zipCode(),
        country: "USA",
      },
      role: "user",
      isActive: true,
      createdAt: faker.date.past(),
      ...overrides,
    };
  }
// ... (詳細な実装についてはリファレンスガイドを参照)

リファレンスガイド

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

ベストプラクティス

✅ する

• 現実的なデータにはfakerライブラリを使用する
• 一般的なオブジェクト用に再利用可能なファクトリを作成する
• オーバーライド機能を使ってファクトリを柔軟にする
• 必要に応じて一意の値を生成する（メール、ID）
• 複雑なオブジェクト構築にはビルダーを使用する
• 統合テストのセットアップ用にフィクスチャを作成する
• エッジケース（空文字列、null、境界値）を生成する
• 可能な限りテストデータを確定的にする

❌ しない

• テストデータを複数の箇所にハードコードしない
• テストに本番データを使用しない
• 再現可能なテストのために真にランダムなデータを生成しない
• ファクトリの階層を過度に複雑にしない
• データの関係と制約を無視しない
• 単純なテスト用に膨大なデータセットを生成しない
• 生成されたデータのクリーンアップを忘れない
• すべてのテストに同じテストデータを使用しない