テスト自動化フレームワーク

目次

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

概要

テスト自動化フレームワークは、自動化されたテストに構造性、再利用性、保守性をもたらします。テストの整理方法、テストデータの管理、依存関係の処理、レポート生成のパターンを定義します。設計が優れたフレームワークは、重複を減らし、信頼性を向上させ、テスト開発を加速させます。

使用する場合

• 新しいテスト自動化のセットアップ
• 既存のテストスイートのスケーリング
• チーム全体でのテストプラクティスの標準化
• テスト保守の負担軽減
• テストの信頼性と速度の向上
• 大規模なテストコードベースの整理
• 再利用可能なテストユーティリティの実装
• 一貫したレポート作成

クイックスタート

最小限の実装例：

// framework/pages/BasePage.ts
import { Page, Locator } from "@playwright/test";

export abstract class BasePage {
  constructor(protected page: Page) {}

  async goto(path: string) {
    await this.page.goto(path);
  }

  async waitForPageLoad() {
    await this.page.waitForLoadState("networkidle");
  }

  async takeScreenshot(name: string) {
    await this.page.screenshot({ path: `screenshots/${name}.png` });
  }

  protected async clickAndWait(locator: Locator) {
    await Promise.all([
      this.page.waitForResponse((resp) => resp.status() === 200),
      locator.click(),
    ]);
  }
}
// ... (詳細な実装についてはリファレンスガイドを参照してください)

リファレンスガイド

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

ガイド	内容
Page Object Model (Playwright/TypeScript)	Page Object Model (Playwright/TypeScript)
Test Fixtures and Factories	テストフィクスチャとファクトリ
Custom Test Utilities	カスタムテストユーティリティ
Configuration Management	設定管理
Custom Reporter	カスタムレポーター
pytest Framework (Python)	pytest フレームワーク (Python)
Test Organization	テスト組織

ベストプラクティス

✅ すべきこと

• UIテストに Page Object Model を使用する
• 再利用可能なテストユーティリティを作成する
• 適切な待機戦略を実装する
• テストデータにはフィクスチャを使用する
• 複数の環境に対応する設定を行う
• 読みやすいテストレポートを生成する
• テストを機能またはタイプ別に整理する
• テストフレームワークをバージョン管理する

❌ してはいけないこと

• テストロジックをページオブジェクトに含める
• ハードコードされた待機時間 (sleep) を使用する
• テストセットアップコードを重複させる
• テストデータをテストロジックと混合させる
• エラーハンドリングをスキップする
• テストの不安定性を無視する
• 過度に複雑な抽象化を作成する
• 環境 URL をハードコードする