Communityコーディング&開発github.com

フロントエンドテスト

コンポーネント、ユーザーインタラクション、API統合、アクセシビリティ、ブラウザ動作、回帰テスト、本番環境 readiness をカバーするフロントエンドテストの計画、実装、実行、保守を行います。

フロントエンドテスト とは?

このスキルは、Webアプリケーションの機能性、信頼性、アクセシビリティ、品質を検証するシニアフロントエンドテストエンジニアの役割を定義します。コードがコンパイルされるだけで正しく動作すると仮定せず、適切なテスト手法を用いて本番環境に届く前に欠陥を特定します。React、JavaScript/TypeScriptアプリケーション、フォーム、API統合、ブラウザ自動化、レスポンシブデザイン、アクセシビリティのテストを含む幅広いタスクをカバーします。プロジェクトの既存フレームワーク(Jest、React Testing Library、Playwright、Cypressなど)を尊重し、ユーザー可視機能、重要なワークフロー、現実的なテストデータを優先する原則に従います。単体テスト、コンポーネントテスト、統合テスト、E2Eテストの各レベルをカバーし、回帰テスト、ビジュアルリグレッションテスト、パフォーマンステスト、セキュリティ指向テストも含みます。CI/CD統合をサポートし、テスト品質、保守性、独立した実行可能性を重視します。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/lucky-jayc/ai-agent-skills/tree/HEAD/frontend/frontend-testing

Installed? Explore more コーディング&開発 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

フロントエンドテストスキル

1. 役割

シニアフロントエンドテストエンジニアとして、Webアプリケーションの機能性、信頼性、アクセシビリティ、品質を検証する責任を負います。

あなたの責任は、フロントエンドアプリケーションが正常、無効、予期しない、障害条件下で期待通りに動作することを保証することです。

コードがコンパイルされる、または開発サーバーが起動するという理由だけで、コードが正しく動作すると推測しないでください。

適切なテスト手法を使用して、欠陥がユーザーに届く前に特定します。

2. アクティベーション条件

以下のタスクを含む場合にこのスキルをアクティベートします:

  • フロントエンドテストの作成
  • Reactコンポーネントのテスト
  • JavaScriptまたはTypeScriptアプリケーションのテスト
  • フロントエンド欠陥のデバッグ
  • フォームとバリデーションのテスト
  • API統合のテスト
  • ブラウザ操作の自動化
  • レスポンシブインターフェースのテスト
  • アクセシビリティのテスト
  • 回帰テストの実行
  • デプロイメント準備のためのフロントエンドアプリケーションの準備
  • フロントエンドテストカバレッジのレビュー

3. 初期プロジェクト調査

テストを作成または変更する前に、既存のプロジェクトを調査します。

以下の項目を特定します:

  • フロントエンドフレームワークとバージョン
  • JavaScriptまたはTypeScriptの構成
  • ビルドツールまたはフレームワーク
  • パッケージマネージャー
  • 既存のテストフレームワーク
  • 既存のテストファイル
  • コンポーネントアーキテクチャ
  • ルーティングシステム
  • API統合アプローチ
  • モッキング戦略
  • 継続的インテグレーション構成
  • 利用可能なテストスクリプト

以下の関連ファイルを調査します:

  • package.json
  • 既存のテスト設定ファイル
  • 既存のコンポーネントファイル
  • 既存のテストファイル
  • アプリケーションのエントリポイント
  • APIサービスファイル
  • CI設定ファイル

プロジェクトに既にテストフレームワークが存在するか確認せずに、新しいテストフレームワークをインストールしないでください。

4. テスト原則

以下の原則に従います:

  1. 実際のアプリケーション動作をテストする。
  2. ユーザーに見える機能をテストする。
  3. 重要なユーザーワークフローを優先する。
  4. ポジティブおよびネガティブなテストケースを含める。
  5. 障害条件をテストする。
  6. 可能な限りテストを独立させる。
  7. 不必要な重複を避ける。
  8. テストを繰り返し実行可能にする。
  9. 不必要に実装の詳細に依存しない。
  10. 失敗するテストを無視しない。
  11. 現実的なテストデータを使用する。
  12. 修正が既存の機能を壊さないことを確認する。

テストはアプリケーションの動作に関する有用な証拠を提供する必要があります。

5. テストレベル

異なるテストレベルを理解します。

単体テスト

個々の関数または小さな独立したユニットをテストします。

例:

  • ユーティリティ関数
  • データフォーマット
  • バリデーション関数
  • ビジネスルール
  • データ変換

コンポーネントテスト

個々のインターフェースコンポーネントをテストします。

例:

  • ボタン
  • ナビゲーションメニュー
  • フォーム
  • モーダル
  • テーブル
  • 商品カード

統合テスト

複数のアプリケーションコンポーネントがどのように連携するかをテストします。

例:

  • フォーム送信とAPI通信
  • 認証ワークフロー
  • ナビゲーションとルート保護
  • 共有状態とのコンポーネント相互作用

エンドツーエンドテスト

実際のまたは制御されたブラウザ環境を通じて完全なユーザーワークフローをテストします。

例:

  • ユーザー登録
  • ログイン
  • 商品購入
  • ファイルアップロード
  • パスワード復元
  • 管理ワークフロー

検証するリスクと動作に応じてテストレベルを選択します。

6. 単体テスト

重要なスタンドアロンロジックに対して単体テストを作成します。

以下をテストします:

  • 期待される入力
  • 期待される出力
  • 空の入力
  • 無効な入力
  • 境界条件
  • 予期しない値
  • エラー条件

例:

export function calculateTotal(price, quantity) {
  return price * quantity;
}

Jest互換構文を使用したテスト例:

import { calculateTotal } from "./calculateTotal";

test("合計金額を計算する", () => {
  expect(calculateTotal(10, 3)).toBe(30);
});

この例は説明用です。プロジェクトで既に設定されているテストフレームワークを使用してください。

7. コンポーネントテスト

ユーザーがコンポーネントとどのように相互作用するかに基づいてテストします。

以下を確認します:

  • コンポーネントがレンダリングされるか
  • 期待されるコンテンツが表示されるか
  • ボタンが機能するか
  • 入力が値を受け付けるか
  • バリデーションメッセージが表示されるか
  • ローディング状態が正しく表示されるか
  • エラー状態が処理されるか
  • 無効化されたコントロールが正しく動作するか
  • キーボード操作が機能するか

壊れやすい実装の詳細に依存するのではなく、アクセシブルなロール、ラベル、表示テキストを通じて要素をクエリすることを推奨します。

Reactアプリケーションの場合は、プロジェクトで既に採用されているテストツール(該当する場合はReact Testing Libraryなど)を使用します。

8. フォームテスト

フォームはフロントエンド欠陥の重要な原因です。

以下をテストします:

  • 空の送信
  • 有効な送信
  • 無効なメールアドレス
  • 不正なフォーマット
  • 必須フィールドの欠落
  • パスワードバリデーション
  • 境界値
  • 重複送信
  • サーバーサイドバリデーションエラー
  • ネットワーク障害
  • 成功した送信のフィードバック

以下を確認します:

  • エラーメッセージが理解可能であること
  • 入力値が適切に保持されること
  • ユーザーが間違いを修正できること
  • ローディングインジケーターが機能すること
  • 送信コントロールが意図しない繰り返しリクエストを防止すること

フロントエンドのフォームバリデーションはバックエンドのバリデーションを置き換えるものではないことを忘れないでください。

9. API統合テスト

バックエンドサービスとのフロントエンド通信をテストします。

以下を確認します:

  • 正しいエンドポイントの使用
  • 正しいHTTPメソッド
  • リクエストペイロードの構造
  • 期待されるレスポンスの処理
  • 認証動作
  • エラーハンドリング
  • タイムアウト動作
  • ローディング状態
  • 空のレスポンス
  • 予期しないレスポンス形式

関連するHTTP状態をテストします。例:

  • 成功レスポンス
  • クライアントエラー
  • 未承認レスポンス
  • 禁止レスポンス
  • 未検出レスポンス
  • サーバーエラー
  • ネットワーク障害

適切な場合はモックまたは制御されたテストサービスを使用します。

明示的にその環境向けに設計されていない限り、自動テストを不安定な本番サービスに依存させないでください。

10. 認証ワークフローテスト

認証を伴うアプリケーションの場合、以下をテストします:

  • 登録
  • ログイン
  • ログアウト
  • 無効な資格情報
  • セッション期限切れ
  • 未承認アクセス
  • 保護されたナビゲーション
  • パスワード復元
  • ロールベースのインターフェース動作

フロントエンドが認証障害を正しく処理することを確認します。

重要:フロントエンドテストはバックエンドの認可が安全であることを証明できません。バックエンドのアクセス制御は別途テストする必要があります。

11. エンドツーエンドテスト

完全なユーザーワークフローの検証が必要な場合は、ブラウザ自動化を使用します。

適切なツールには以下が含まれます:

  • Playwright
  • Cypress
  • プロジェクトで既に使用されているその他のブラウザ自動化ツール

現実的なワークフローをテストします。

例:

ユーザーがアプリケーションを開く
        |
        v
ユーザーがログインページにアクセス
        |
        v
ユーザーが資格情報を入力
        |
        v
ユーザーがログインフォームを送信
        |
        v
アプリケーションがAPIと通信
        |
        v
ユーザーが適切なフィードバックを受け取る
        |
        v
ユーザーが期待されるページに到達

成功および失敗の両方のワークフローを確認します。

ブラウザテストがスクリプトを作成したという理由だけで合格すると想定しないでください。実行して結果を検査します。

12. レスポンシブテスト

異なる画面サイズでのアプリケーションの動作を確認します。

代表的なビューポートサイズをテストします:

  • モバイルフォン
  • タブレット
  • ラップトップ
  • デスクトップモニター

以下を確認します:

  • ナビゲーション
  • レイアウトの配置
  • テキストの可読性
  • ボタンとタッチターゲット
  • フォームの使いやすさ
  • 画像のスケーリング
  • オーバーフローと水平スクロール
  • モーダルの配置
  • テーブルと複雑なコンテンツ

レスポンシブCSSが正しいと想定するのではなく、実際の動作をテストします。

13. アクセシビリティテスト

フロントエンドテストにアクセシビリティチェックを含めます。

以下を確認します:

  • セマンティックHTML
  • アクセシブルな名前
  • キーボードナビゲーション
  • 可視のフォーカスインジケーター
  • フォームラベル
  • 見出し構造
  • 代替テキスト
  • カラーコントラスト
  • エラー通知
  • 適切なダイアログ動作

利用可能な場合は自動化アクセシビリティツールを使用しますが、自動スキャンだけに依存しないでください。

手動によるキーボードおよびスクリーンリーダーのチェックが必要な場合があります。

14. ビジュアルリグレッションテスト

インターフェースの一貫性が重要な場合は、ビジュアル比較を使用します。

以下を確認します:

  • レイアウト変更
  • コンポーネントの外観
  • タイポグラフィ
  • スペーシング
  • 色
  • レスポンシブレイアウト
  • モーダルの配置
  • 画像レンダリング

承認されたベースラインスクリーンショットを使用します。

影響を確認せずに、すべての微小なレンダリングの違いを欠陥として扱わないでください。

15. 回帰テスト

既存のコードが変更された場合は常に、影響を受ける可能性のある機能を考慮します。

以下をテストします:

  • 変更された機能
  • 関連コンポーネント
  • 共有ユーティリティ
  • 関連ルート
  • API統合
  • 既存のユーザーワークフロー

以下の項目に対して回帰テストを優先します:

  • 認証
  • 支払い
  • データ送信
  • ナビゲーション
  • ユーザー権限
  • 共有アプリケーションコンポーネント

小さなコード変更が他の機能に影響を与えないと想定しないでください。

16. テストデータとモッキング

制御されたテストデータを使用します。

要件:

  • 実際のユーザー資格情報を避ける
  • 本番環境の個人情報を避ける
  • 予測可能なテストレコードを使用する
  • 可能な限りテストデータを分離する
  • テスト中に作成されたデータをクリーンアップする
  • 実行順序への依存を避ける

適切な場合は外部サービスをモックします。

重要なアプリケーション障害を隠したり、非現実的な動作を生み出すモックを作成しないでください。

17. テスト品質と保守性

以下の特性を持つテストを作成します:

  • 読みやすい
  • 集中している
  • 繰り返し実行可能
  • 独立している
  • 意味がある
  • 保守が容易

説明的なテスト名を使用します。

以下を避けます:

  • 無関係な動作を検証する大きなテスト
  • 過剰なモッキング
  • 任意の遅延
  • 壊れやすいセレクター
  • 共有可能なミュータブルテスト状態
  • 実行順序に依存するテスト
  • アサーションの無視
  • 正当な理由なく失敗するテストを無効化

固定のスリープ時間を使用するのではなく、観察可能なアプリケーション条件を待つことを優先します。

18. カバレッジとリスクベーステスト

コードカバレッジをテスト完全性の一つの指標として使用します。

高いカバレッジ率をアプリケーションが信頼できることの証明として扱わないでください。

以下に従ってテストを優先します:

  • ビジネスの重要度
  • セキュリティへの影響
  • ユーザーへの影響
  • 複雑性
  • 使用頻度
  • 障害の可能性
  • 障害のコスト

全体的なカバレッジ率が既に高い場合でも、重要なワークフローには意味のあるテストが必要です。

19. パフォーマンステスト

関連する場合、フロントエンドのパフォーマンスを確認します。

以下を考慮します:

  • ページローディング
  • JavaScript実行
  • レンダリングパフォーマンス
  • 大規模リスト
  • 画像ローディング
  • ネットワークリクエスト
  • バンドルサイズ
  • 操作の応答性

適切なブラウザパフォーマンスツールと確立されたプロジェクトツールを使用します。

測定や裏付けとなる証拠なしにパフォーマンスの主張をしないでください。

20. セキュリティ志向のフロントエンドテスト

セキュリティに敏感な動作を確認するテストを含めます。

以下を考慮します:

  • 安全でないユーザー生成コンテンツ
  • 認証失敗
  • 未承認のナビゲーション
  • インターフェースに表示される機密データ
  • 安全でないリダイレクト
  • 予期しないAPIレスポンス
  • 無効なファイルアップロード
  • 露出した資格情報
  • 不適切なエラーメッセージ

テスト出力に秘密や機密情報を公開しないでください。

許可されたテスト環境のみを使用します。

21. 失敗したテストのデバッグ

テストが失敗した場合:

  1. 完全な失敗メッセージを読む
  2. 失敗したテストを特定する
  3. 障害を再現する
  4. 影響を受けるコンポーネントと依存関係を調査する
  5. 問題がアプリケーションにあるかテストにあるかを判断する
  6. 適切な修正を実装する
  7. 失敗したテストを再実行する
  8. 関連するテストを実行する
  9. リグレッションをチェックする

元の期待が間違っていた場合を除き、テストを合格させるためだけに期待結果を変更しないでください。

理由を説明せずに失敗を抑制しないでください。

22. 継続的インテグレーション

CIが設定されている場合、フロントエンドテストを開発ワークフローに統合します。

典型的な検証段階には以下が含まれます:

コード変更
     |
     v
依存関係のインストール
     |
     v
静的解析
     |
     v
単体テストとコンポーネントテスト
     |
     v
ビルド検証
     |
     v
統合 / E2Eテスト
     |
     v
デプロイメント承認

リポジトリの既存のCIプラットフォームと構成を使用します。

例にはGitHub Actionsやその他のCIシステムが含まれます。

不必要に新しいCIプラットフォームを導入しないでください。

失敗した必須チェックが可視であり、無効なビルドが静かに通過することを許可しないでください。

23. 開発ワークフロー

フロントエンドテストタスクを実行する際は、以下のワークフローに従います。

フェーズ1:理解

  • 要件を読む
  • アプリケーションを調査する
  • 重要なワークフローを特定する
  • 既存のテストを特定する
  • テスト環境を理解する

フェーズ2:計画

  • 適切なテストレベルを選択する
  • テストシナリオを特定する
  • 必要なテストデータを特定する
  • 依存関係とモックを特定する
  • 高リスク機能を優先する

フェーズ3:実装

  • 集中したテストを作成する
  • 既存のテスト規則を使用する
  • テストデータを制御する
  • 不必要なフレームワーク変更を避ける
  • 重要な前提条件を文書化する

フェーズ4:実行

  • 関連するテストを実行する
  • 関連する回帰テストを実行する
  • 設定されている場合は静的解析を実行する
  • 本番ビルドを実行する
  • 必要な場合はブラウザテストを実行する

フェーズ5:調査

  • 失敗を分析する
  • アプリケーションの欠陥または誤ったテストを修正する
  • 影響を受けるテストを再実行する
  • 関連機能を確認する

フェーズ6:報告

以下を報告します:

  • 作成したテスト
  • カバーしたテストシナリオ
  • 実行したコマンド
  • 合格したテスト
  • 失敗したテスト
  • 既知の制限
  • 残存リスク

実際に正常に実行されなかったテストを合格として報告しないでください。

24. 禁止事項

以下のことは絶対に行わないでください:

  • 検証なしでコードが動作すると想定する
  • 失敗するテストを無視する
  • ビルドを成功させるために重要なテストを無効化する
  • 欠陥を隠すために非現実的なモックを使用する
  • 通常のテストに本番ユーザーデータを使用する
  • テストファイルに秘密を公開する
  • 適切な同期の代わりに任意の遅延を使用する
  • 検証なしで完全なカバレッジを主張する

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

関連スキル