e2e-testing-patterns

E2E テストパターン

信頼性が高く、高速で、保守しやすいエンドツーエンドテストスイートを構築し、素早くコードをリリースする自信を得るとともに、ユーザーより先にリグレッションを検出しましょう。

このスキルを使用する場合

• エンドツーエンドテストの自動化を実装するとき
• 不安定なテストや信頼性の低いテストをデバッグするとき
• 重要なユーザーワークフローをテストするとき
• CI/CD テストパイプラインをセットアップするとき
• 複数のブラウザーでテストするとき
• アクセシビリティ要件を検証するとき
• レスポンシブデザインをテストするとき
• E2E テスト標準を確立するとき

このスキルを使用しない場合

• 単体テストや統合テストのみが必要な場合
• 環境が安定した UI 自動化をサポートできない場合
• 安全なテストアカウントやデータを用意できない場合

手順

1. 重要なユーザージャーニーと成功基準を特定します。
2. 安定したセレクターとテストデータ戦略を構築します。
3. 観測可能なアサーションとトレーシングを備えた分離されたテストを実装します。リトライを通常の成功として数えるのではなく、リトライの原因を診断します。
4. 並列化とアーティファクトのキャプチャを有効にして CI で実行します。

安全性

• 本番環境に対して破壊的なテストを実行することは避けてください。
• 専用のテストデータを使用し、機密性の高い出力をマスクしてください。

リソース

• 詳細な E2E パターンとテンプレートについては resources/implementation-playbook.md を参照してください。

実例

入力: レンダリングが完了する前にテストがエラーを読み取るため、無効なログインが成功したように見えることがあります。専用のフィクスチャアカウントを使用し、await expect(page.getByRole('alert')).toContainText('Invalid credentials') をアサートします。リトライなしでテストを実行し、ダッシュボードに引き続きアクセスできないことを確認します。期待される結果: 失敗状態が確実に観測され、遅延したエラーがサイレントに成功扱いされることはありません。

入力と前提条件

承認されたテスト URL、分離されたアカウント/データ、インストール済みのブラウザーランナー、および既知の成功/失敗状態。プレイブックはプロジェクト固有のルートとアダプターを使用します。既存のスイートが必要とする依存関係のみをインストールしてください。

制限事項

• モック化されたバックエンドや決済プロバイダーは、モック化された境界のみを検証します。別途、実際の統合チェックを維持してください。
• 自動アクセシビリティスキャンは、インタラクションや支援技術に関する問題を見逃します。
• リトライ、より長いタイムアウト、更新されたスナップショットはリグレッションを隠す可能性があります。初回失敗時の証拠を保持してください。
• ブラウザーツールは、ロックされた環境や利用できないインタラクティブ環境を検証できません。そのギャップを報告し、独立したテストを続行してください。