1
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

テスト自動化で本当に難しいのは「作ること」ではなく「保守すること」

1
Posted at

what-happens-when-claude-is-down-and-your-playwright-tests-need-changes.jpg

テスト自動化で最も簡単なのは、最初の1本を作ることです。

対象となる操作を決め、ステップを記録するかコードを書き、アサーションを追加して実行する。テストが成功すれば、プロジェクトは順調に見えます。

しかし、本当の難しさは数週間後から始まります。

  • UIの構造が変わる
  • テストデータの有効期限が切れる
  • コンポーネントの描画が非同期になる
  • 外部APIの応答が遅くなる
  • 1つだけだった要素が複数に増える
  • ローカルでは通るのにCIだけで失敗する

この段階になると、重要な問いは次のように変わります。

どれだけ速くテストを作れるか

ではなく、

作ったテストを、どれだけ低いコストで信頼できる状態に保てるか

です。

AIによってPlaywrightのコードやブラウザテスト、テストデータ、アサーションを短時間で生成できるようになった今、この違いは以前より重要になっています。

テスト生成のコストは下がっています。

一方で、保守、障害解析、テスト結果への信頼を維持するコストは、それほど簡単には下がりません。

テスト生成速度だけでは品質を判断できない

AIエージェントが短いプロンプトからブラウザテスト一式を生成するデモは、見た目として非常に分かりやすいものです。

ただし、短時間で生成できたことと、そのテストを長期間運用できることは別問題です。

生成されたテストには、次のような問題が含まれる可能性があります。

  • DOM構造に依存した壊れやすいセレクタ
  • 画面状態に関する誤った前提
  • 必要以上に長い待機処理
  • 重複したセットアップコード
  • 実質的な品質を確認していないアサーション
  • 特定のテストデータに依存した処理

そのため、AIテストツールを評価するときは、生成時の成功率だけでなく、将来発生する作業量も測る必要があります。

AIテストの保守コストを予測する評価指標では、次のような指標が重要だと説明されています。

  • 生成後に人間による修正が必要になった割合
  • UI変更によってテストが壊れる頻度
  • 失敗原因を理解するまでにかかる時間
  • プロダクト側の不具合とテスト側の不具合の比率
  • 成功するまでに必要なリトライ回数
  • 重複しているテストロジックの量
  • 別の担当者がテストを修正するまでにかかる時間

5分で生成できても、毎月2時間の修正が必要なら、そのテストのコストは5分ではありません。

人間が読める形式で保存されているか

テストの保守コストを下げる方法のひとつは、フレームワークの内部構造を理解しなくても内容を把握できる形式でテストを保存することです。

コードベースのテスト自動化には、高い柔軟性があります。

一方で、チーム側で次の要素を管理する必要があります。

  • テストフレームワークの依存関係
  • 共通ヘルパーやライブラリ
  • ブラウザ設定
  • レポート機能
  • リトライ処理
  • テストデータ生成
  • 並列実行環境
  • CIとの連携
  • 独自のデバッグ用ツール

AIを使えば、これらのコードを書く作業を支援できます。

しかし、構成そのものが単純になるわけではありません。AIがアプリケーションや既存フレームワークを正しく理解したかどうかを、人間が確認する作業も発生します。

もうひとつの選択肢は、AIやレコーダーを使ってテストを作成しつつ、最終的なテストを構造化された、人間が読みやすい形式で保存することです。

Endtestの最も簡単にテストを自動化する方法では、このアプローチについて説明されています。

重要なのは、単にテスト作成が簡単になることではありません。

生成後のテストを、人間が確認、編集、再利用できる状態で維持できることです。

テストを修正するたびに、大量のフレームワークコードをAIや人間が読み直す必要がなくなります。

もちろん、コードベースのフレームワークが間違っているわけではありません。

誰がテストを所有し、誰が将来修正するのかを考えたうえで選ぶ必要がある、ということです。

動的フォームはテスト保守性を確認するのに向いている

動的フォームは、ブラウザテストの実力を確認するうえで非常に良い題材です。

動的フォームには、次のような要素が含まれます。

  • 入力内容によって表示される条件分岐フィールド
  • カスタムドロップダウン
  • 日付選択UI
  • 非同期バリデーション
  • オートコンプリート
  • 繰り返し可能な入力項目
  • ファイルアップロード
  • 前の回答を使って自動入力されるフィールド

作成時には正常だったテストが、入力項目を1つ追加しただけで壊れることもあります。

動的フォームにおけるEndtestとPlaywrightの比較では、両者のトレードオフが整理されています。

Playwrightは、細かい制御ができる強力なAPIを提供します。

高度にカスタマイズされたアプリケーションや、テストコードを継続的に保守できるチームでは大きな利点があります。

一方、より高レベルなテストプラットフォームでは、テストステップ、再利用可能なフロー、ロケータを確認しやすくし、保守作業を減らせる可能性があります。

比較するときに見るべきなのは、

今日このフォームを自動化できるか

ではありません。

12回UIが変更されたあとでも、無理なく修正できるか

です。

UI変更が多いチームでは、ツール評価の方法を変える

多くのテストツールは、短期間のPoCでは問題なく動きます。

安定した5つのシナリオを自動化し、10回実行して10回成功すれば、十分に信頼できるように見えます。

しかし、それで分かるのは現時点のプロダクトに対して動くということだけです。

次のような変更が起きたときの挙動は分かりません。

  • コンポーネントのリファクタリング
  • ボタンやラベルの文言変更
  • ナビゲーション構造の変更
  • ローディング処理の追加
  • デザインシステムの更新
  • 共通フローの再利用方法の変更

UIが毎週変わるチーム向けのAIテストプラットフォーム選定ガイドでは、単に実行結果を見るのではなく、変更に対する耐性を評価する必要があると説明されています。

実用的なPoCでは、意図的にアプリケーションを変更してみるべきです。

例えば、次のような流れです。

  1. 実際の業務に近いフローを自動化する
  2. ボタンの文言を変更する
  3. フォーム項目を別コンポーネントへ移動する
  4. 中間ローディング状態を追加する
  5. 同じ種類の要素の並び順を変更する
  6. 作成者以外のメンバーに修正してもらう

最初のテスト作成よりも、壊れたあとの修正作業のほうが、ツールの実力をよく表します。

「フレークテスト」の原因がフロントエンド側にあることも多い

ブラウザテストが不安定になると、最初にテストコードを修正したくなります。

  • 待機時間を長くする
  • クリックをリトライする
  • セレクタを変更する
  • タイムアウトを延ばす

もちろん、テスト側の修正が正しい場合もあります。

しかし、テスト失敗がフロントエンドの不安定さを正しく検出しているケースもあります。

代表的な例が、Hydration Mismatchです。

SSRを利用しているアプリケーションでは、まずサーバーが生成したHTMLが表示され、そのあとクライアント側のフレームワークがHydrationを行います。

サーバー側のHTMLとクライアント側の初期描画が一致しない場合、要素が再生成されることがあります。

テストがボタンを見つけた直後に、そのDOMノードが差し替えられると、クリックは失敗します。

Hydration Mismatchがブラウザテストを壊す前にデバッグする方法では、この種の問題がランダムに見える理由が解説されています。

根本的な修正は、テストではなくアプリケーション側にあるかもしれません。

  • サーバーレンダリングで非決定的な値を使わない
  • ブラウザでしか取得できない値をSSR中に表示しない
  • 初期状態を安定させる
  • 不正なHTML構造を修正する
  • クライアント依存の描画タイミングを調整する

テストは正当な非同期処理には対応すべきです。

ただし、アプリケーションの構造的な不安定さまで隠すべきではありません。

セッションリプレイは動画を残すだけでは不十分

スクリーンショットは便利ですが、失敗した瞬間の最終状態しか分からない場合があります。

例えば、ボタンが見つからなかったとしても、スクリーンショットだけでは次のどれが原因か判断できません。

  • 最初からボタンが描画されなかった
  • 一度表示されたあと消えた
  • 直前の操作が失敗した
  • 別ページへリダイレクトされた
  • オーバーレイに遮られていた
  • JavaScriptエラーで描画が停止した
  • ページがまだ読み込み中だった

セッションリプレイがあれば、失敗までの流れを確認できます。

ただし、動画を保存するだけでは十分ではありません。

タイムスタンプ、ネットワーク情報、DOM変更、テストステップとの関連付けがなければ、結局原因を推測することになります。

不安定なUIテスト向けのブラウザセッションリプレイ運用では、失敗したステップと証拠を結びつけることの重要性が説明されています。

理想的には、次の情報を確認できるべきです。

  • 最後に成功した操作
  • 失敗前後のDOM状態
  • コンソールエラー
  • 関連するネットワークリクエスト
  • URLやリダイレクトの変化
  • 重要なタイミングのスクリーンショット
  • 成功した実行との時間差

目的は、成果物を大量に保存することではありません。

「テストが失敗した」から「原因はおそらくこれだ」までの時間を短縮することです。

フレークは単発の失敗ではなく、傾向として見る

多くのチームでは、フレークテストを実行単位で処理しています。

失敗したら再実行し、成功したら忘れる。

この運用では、徐々に悪化していることに気付きにくくなります。

あるテストが次のように変化していたとします。

  • 1月は100回に1回失敗
  • 2月は40回に1回失敗
  • 3月は15回に1回失敗

個別の失敗は小さく見えますが、傾向としては明らかに悪化しています。

CIにフレークテストの異常検知を追加する方法では、こうした変化を検出する方法が紹介されています。

必ずしも高度な機械学習は必要ありません。

次のようなデータを保存するだけでも、十分に役立ちます。

  • 失敗率
  • リトライ率
  • 実行時間の中央値やパーセンタイル
  • ブラウザ別の失敗傾向
  • Worker別の失敗傾向
  • 時間帯別の傾向
  • デプロイとの相関
  • 並列実行数との相関

重要なのは、フレークを単発のイベントではなく、履歴を持った挙動として扱うことです。

開発者が赤いCIを「たぶんフレークだろう」と考え始めた時点で、テストスイートの価値は大きく下がっています。

CIでは、すべてではなく重要なテストを実行する

保守コストを増やす原因のひとつが、必要以上のテスト実行です。

安全そうに見えるため、すべての変更に対してテストスイート全体を実行しているチームは少なくありません。

しかし、実行数を増やすだけでは、フィードバックの質は上がりません。

大規模なテストスイートは次の問題を引き起こします。

  • CIの待ち時間が長くなる
  • インフラコストが増える
  • 関係のない失敗が増える
  • 開発者が結果を確認しなくなる
  • フィードバックループが遅くなる

Test Impact Analysisでは、コード変更と関係の深いテストを優先して実行します。

高速なCI/CD判断のためのTest Impact Analysis構築方法では、次のような情報を利用する方法が説明されています。

  • 変更されたファイル
  • 影響を受けるコンポーネント
  • 呼び出されるサービス
  • 利用されるルート
  • 過去の変更と失敗の関係
  • テストの所有者情報
  • 共通依存関係

最初から完全な仕組みを作る必要はありません。

例えば、次のように分けるだけでも効果があります。

  • Pull Requestごとに小規模な重要テストを実行
  • 変更箇所に関連するテストを追加実行
  • マージ後に広めの回帰テストを実行
  • 定期的に全テストを実行

これにより、網羅性を維持しながら、フィードバック速度を改善できます。

インフラの遅延がテストの不安定さに見えることもある

不安定なブラウザテストの原因は、セレクタ、テストデータ、アプリケーションコードだけではありません。

分散ブラウザ環境そのものが原因になることもあります。

Selenium Gridでは、コマンドが次の複数のシステム間を移動します。

  • テストランナー
  • GridのルーターやHub
  • ブラウザNode
  • アプリケーションサーバー
  • 外部サービス

どこかで遅延が発生すると、実行タイミングが変わります。

Selenium Gridのネットワークボトルネックを検出する方法では、インフラ側の挙動を直接測定する重要性が説明されています。

確認すべき指標には、次のようなものがあります。

  • ブラウザセッション作成時間
  • コマンドの往復遅延
  • NodeのCPUとメモリ使用率
  • ランナーとNode間のネットワーク遅延
  • 特定マシンへの失敗集中
  • 並列実行数を増やしたときの成功率変化

こうした情報がないと、インフラ障害に対してテストへ不要な待機処理を追加してしまうことがあります。

その結果、テストスイートは遅くなり、根本原因は残ったままです。

AIエージェントは最終出力だけでなく処理全体をテストする

AIエージェントのテストでは、最終的な回答だけを確認しても十分ではありません。

エージェントは、内部で次のような処理を行います。

  1. ユーザーの要求を解釈する
  2. 使用するツールを選ぶ
  3. 引数を生成する
  4. 結果を解釈する
  5. メモリを更新する
  6. 次の操作が必要か判断する
  7. エラーから復旧する

最終回答が正しく見えても、その途中で危険な処理を行っている可能性があります。

例えば、誤ったAPIを呼び出し、一部のデータを更新したあと、別のAPIでリトライして成功したとします。

最終メッセージだけを検証すると、この問題は見逃されます。

AIエージェントのツール利用、メモリ、リカバリ経路をテストする方法では、出力だけでなく実行プロセスも検証する必要があると説明されています。

確認すべき項目には、次のようなものがあります。

  • 正しいツールを選択したか
  • 引数が正しいか
  • リトライ回数が制限されているか
  • 部分的な副作用が残っていないか
  • メモリ更新が正しいか
  • 不正な応答から復旧できるか
  • 確信がない場合に人間へエスカレーションできるか

AIエージェントの信頼性は、回答の正確さだけではありません。

理想的な経路から外れたときに、安全かつ予測可能に動作することも含まれます。

LLMプロンプトには回帰テスト用データセットが必要

プロンプトエンジニアリングは、感覚的な作業として扱われがちです。

プロンプトを変更し、いくつかの入力で試し、以前より良くなったように見えればリリースする。

しかし、あるケースを改善した変更が、別のケースを悪化させることがあります。

プロンプト変更は次の要素に影響します。

  • 出力形式
  • 事実性
  • 拒否挙動
  • ツール選択
  • 文体
  • 回答の完全性
  • レイテンシ
  • トークン使用量

手動QAを増やさずにLLMプロンプトの回帰テストを行う方法では、バージョン管理された評価データセットの利用が推奨されています。

データセットには、次のような入力を含めると有効です。

  • よくあるユーザー要求
  • 既知のエッジケース
  • 曖昧な要求
  • 敵対的な入力
  • 過去に不具合を起こした入力
  • 必須の出力構造
  • 安全性に関する要件
  • ツール利用に関する期待値

すべてを完全一致で比較する必要はありません。

必要なフィールドが含まれているか、禁止された動作をしていないか、正しいツールを呼んだか、品質基準を満たしているかを評価できます。

目的は、

このプロンプトのほうが何となく良さそう

という判断を、再現可能な証拠に置き換えることです。

テスト自動化ツールを評価する5つの観点

テスト自動化の方法やツールを比較するときは、次の5つの観点が実用的です。

1. 作成

実際の業務に近いテストを、どれくらいの時間で作成できるか。

メインのステップだけでなく、セットアップ、テストデータ、共通フロー、CI設定、レポートも含めて評価します。

2. 変更

UIやワークフローが変更されたとき、どの程度の修正が必要か。

意図的にアプリケーションを変更し、修正時間を測定します。

3. 原因解析

ローカルで再現しなくても、失敗原因を理解できるか。

スクリーンショット、ログ、セッションリプレイ、ネットワーク情報、エラー分類を確認します。

4. 所有可能性

作成者以外のチームメンバーがテストを読んで修正できるか。

特定の担当者だけが理解できるテストスイートは、チームの資産とは言えません。

5. コスト

6か月、12か月単位で見たとき、どれくらいのコストがかかるか。

開発時間、インフラ、実行、保守、失敗調査まで含めて計算します。

この5つを確認することで、デモ中にAIが何本テストを生成できるかよりも、現実的な判断ができます。

まとめ

これからのテスト自動化では、生成速度だけが重要なのではありません。

AIによって、テスト、ロケータ、データ、アサーションの作成は今後も簡単になります。

一方で、次の課題は残ります。

  • テストを人間が理解できる状態に保つ
  • 頻繁なUI変更に耐える
  • 失敗原因を短時間で特定する
  • プロダクトの不具合とインフラ障害を区別する
  • フレークの悪化を早期に検出する
  • AIシステムを最終出力以外の部分まで検証する
  • 長期的な保守コストを管理する

最も優れたテスト自動化の方法は、最も多くのテストを生成できる方法とは限りません。

プロダクト、チーム、インフラが変化したあとも、信頼できる情報を提供し続けられる方法です。

1
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
1
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?