エンドツーエンドテスト (E2E テスト) とは? 実例 1 つで分かるやさしいガイド
エンドツーエンドテスト (E2E テスト) とは? やさしい定義と、ショップアプリの注文という実例を、最初のクリックからビルドのたびに実行されるテストまで追います。
エンドツーエンドテストは、アプリケーションのワークフロー全体を、ユーザーの最初のクリックから最終結果まで、裏側のすべての部分を連携させたまま、実際の画面を通して検証します。ユーザーが求めていたものを手にできることを証明します。
これが最も重要なテストだという点ではどのチームも同意しますが、ほとんどのチームにはごくわずかしかありません。コードで書いたエンドツーエンドテストは作成に時間がかかり、デザイン変更のたびに壊れるため、事業を支えるワークフローは今もリリースのたびに手作業で確認されるか、まったく確認されていません。
エンドツーエンドテスト (E2E テスト) とは?
定義
エンドツーエンドテスト (E2E テストとも書きます) は、アプリケーションをユーザーが使うとおりにテストすることです: 1 つのワークフロー全体を、実際の画面を通して、最初から最後までたどります。テストは人と同じように、クリックし、入力し、表示された内容を読み取ります。画面の裏側にあるものすべてが関わります: サーバー、データベース、ワークフローが呼び出す外部サービスです。ユーザーの最終結果が正しいときにだけ、テストは合格します。
名前にある 2 つの「エンド」とは、ユーザーの最初の操作と、ユーザーの最終結果のことです。その間にあるのが、アプリケーション全体です。エンドツーエンドテストのページでは、Web アプリから Windows デスクトップアプリ、スマートフォンまで、対象となるアプリの種類を紹介しています。
エンドツーエンドテストの例: ショップアプリでの 1 件の注文
この記事では、1 つの例を最後まで追います: オンラインショップの顧客がデスクライトを注文します。画面は 4 つで、ショップにとって決して失えないワークフローです。
サインイン
メールアドレスとパスワードを入力します。
アカウント名が表示されます。
カートに入れる
デスクライトを開いてカートに入れます。
カートに商品 1 点とその価格が表示されます。
支払う
カード情報を入力して「支払う」をクリックします。
エラーメッセージは表示されません。
注文確認
確認ページを読み取ります。
合計金額と注文番号が表示されます。
画面の裏側では、このすべてが動いている必要があります
これを手作業でテストする人は、まさにそのとおりに行います: サインインし、ライトをカートに入れ、テストカードで支払い、確認ページを読みます。エンドツーエンドテストも同じことを同じ順序で行い、途中で同じものを検証します。
小さなテストでは確認できない、エンドツーエンドテストがカバーするもの
小さなテストは、一度に 1 つの部分だけを見ます: 関数、サービス、画面などです。高速で正確で、自分の担当部分については正しく判定します。見えないのは、顧客が体験する、ある部分から次の部分への受け渡しです。
各部分を個別にテスト
注文全体を、画面を通して
確認ページに注文番号が表示されません。
- 注文のエンドツーエンドテストは、小さなテストではカバーできないものをカバーします。サインインが、正しいアカウントで本当にショップへつながることを証明します。ある画面で追加した商品が、次の画面で請求される商品であることを証明します。成功した支払いから、顧客が読める確認が生成されることを証明します。そのすべてを画面上で証明します: 画面では、正しい値でも間違った場所に描かれればバグだからです。
同じバグが、部分のテストと画面のテストでどう見えるかは、エンドツーエンドテストと統合テストの違いで扱っています。割引コードの入力欄のような 1 つの機能だけのテストは、機能テストとはで説明しています。
ワークフローの各ステップで何を検証するか
4 つの画面をクリックして進むだけで何も検証しないエンドツーエンドテストは、アプリがクラッシュしなかったことしか証明しません。各ステップは、ユーザーが目を向けるはずのものの検証で終えます。
| ステップ | テストが検証する内容 | 使うアサーション |
|---|---|---|
| サインイン | ページの上部にアカウント名が表示されます。 | 言葉を読み取るテキストアサーション。 |
| カートに入れる | カートに商品 1 点、ライトの画像、その価格が表示されます。 | 価格にはテキストアサーション、画像にはビジュアルアサーション。 |
| 支払う | 読み込み中のスピナーが消え、エラーメッセージが表示されません。 | ビジュアル不在アサーションとテキスト不在アサーション。 |
| 注文確認 | お礼のメッセージ、支払った合計金額、注文番号。 | テキストアサーションと、番号には動的テキストアサーション。 |
注文番号は、もう少し詳しく見る価値があります: 多くのエンドツーエンドテストがここでつまずくからです。番号は実行のたびに変わるので、記録中に見た番号を期待するアサーションは、翌日にはもう不合格になります。
記録時の番号を期待するアサーション
何も壊れていないのに、2 件目以降の注文はすべて不合格になります。
形式を期待する動的テキストアサーション
本物の注文番号はすべて合格し、壊れた番号はきちんと不合格になります。
エンドツーエンドテストはいつ、いくつ書くべきか
- ワークフローが事業に欠かせないものであれば、エンドツーエンドテストを書きます。お金、個人データ、サインインが関わるものです。アプリケーションの複数の部分や外部サービスをまたぐものです。そこにバグがあると、顧客や同僚が仕事を進められなくなるものです。
いくつ書くべきかの答えは短く、「少しだけ」です。まず、壊れたときの影響が最も大きいワークフローを 1 つ選び、次にほかの欠かせないものを追加します。ほとんどのアプリケーションは、ビルドのたびに実行する 5 件から 15 件のテストで十分に守られます。
すべきこと
- 1 件のテストに、最初のクリックから結果までのワークフロー全体を 1 つ
- 各画面で、ユーザーが目を向けるはずのものを検証するアサーション
- テスト環境、テストアカウント、テスト用の決済カード
避けるべきこと
- すべての画面のすべてのオプションに対するエンドツーエンドテスト
- ワークフローをクリックして進むだけで何も検証しないテスト
- 前日の実行が残したデータに依存するテスト
1 つの画面のオプションは、機能を 1 つずつ扱う短いテストの役目です。エンドツーエンドテストが複数になったら、どれをビルドごとに、どれを夜間に実行するかは、スモークテスト、サニティテスト、リグレッションテストの違いで分かります。
コードで書いた E2E テストの維持が難しい理由
Playwright、Selenium、Cypress のようなコードで書くフレームワークでは、注文のテストはプログラムです。一度書くことは、小さな部分にすぎません。コストになるのは、維持し続けることです。
| 注文のテストに必要なもの | コードで書くフレームワーク | GUI Test Studio |
|---|---|---|
| 各入力欄とボタンを見つける | それぞれにセレクターを用意し、手作業で書いて直します。 | まずアプリのアクセシビリティ情報で、アプリが何も伝えないときは見た目で見つけます。 |
| 各画面を待つ | ページやスピナーごとの待機コード、または固定の待ち時間。 | どのアサーションも自動で待ち、要素が現れた瞬間に合格します。 |
| 注文番号 | コードで書いたパターン。 | 動的テキストアサーション: 番号をマークすると、その形式が認識されます。 |
| 決済画面のデザイン変更 | プログラマーがスクリプトを、セレクターを 1 つずつ直します。 | 確認のうえ、レポートで新しい見た目を 1 クリックで採用します。 |
| 作成できる人 | プログラミングができる人。 | ワークフローを手作業で行える人なら誰でも。 |
エンドツーエンドテストの価値は、維持にかかるコストに見合ってこそです。コードをなくせば、そのコストもなくなります。
正常に動くアプリでの失敗の大半は、この表の 2 つの行が原因です: 要素を見つけることと、それを待つことです。テストの固定スリープでは固定の長さの待ち時間が決して合わない理由を、不安定なテストと誤検知ではそのノイズがチームに与える負担を説明しています。
このエンドツーエンドテストをコードなしで作成する手順
GUI Test Studio は、あらゆるアプリのエンドツーエンドテストをコードなしで自動化します。ここでは、この記事の注文のテストを、何もない状態から自動で動くテストになるまで作ります。作業の大半は、注文を一度行うことです。
- 1
開始状態を準備する
テストアカウントとテスト用の決済カードを用意して、テスト環境を使います。Web アプリの場合、テストは実行のたびにまっさらなブラウザーウィンドウでページを自分で開くので、どの実行も、新しい訪問者と同じくサインアウトした状態から始まります。
- 2
注文を一度記録する
GUI Test Runner-Recorder で「記録」をクリックし、Web アプリを選んでショップのアドレスを入力します。サインインし、デスクライトをカートに入れ、支払い、確認ページを待ってから、Esc を押して停止します。
普段どおりの速さで行い、各ページの読み込みが終わってから操作してください。ワークフローをプロンプトで Claude、Codex 付きの ChatGPT、またはローカル AI モデル (当社が提供するモデルか、独自のモデル) に説明することもできます: プロンプトからテストを作成するをご覧ください。
- 3
テストで検証する内容を選ぶ
「このテストで何を検証しますか」の質問で、テストが自動で持つアサーションが決まります。「ビジュアル要素を検証」と「表示される内容を検証」はオンのままにし、言葉が言葉として検証されるよう「テキストを検証」をオンにしてから、「テストを保存」をクリックします。
記録が終わると一度だけ尋ねられます: 注意深いテスターが行うアサーションを、1 つのウィンドウで選べます。 - 4
注文番号に動的テキストアサーションを付ける
GUI Test Studio でテストを開きます。「アサーション」パレットから動的テキストアサーションを、確認ページが表示される時点へドラッグし、フレーム上で注文番号をマークします。エディターが値の形式を選び、独自の書式はパターンで一度記述すれば済みます。
エディターで開いた動的テキストアサーション (ここでは金額): 値がマークされ、形式が選ばれ、実行で見つかるかどうかをエディターがその場で示します。 - 5
実行して信頼度レポートを読む
「テストを実行」をクリックし、マウスとキーボードには手を触れないでください。実行が終わると、レポートに判定が示され、続いてすべてのステップとアサーションが、期待した内容と実際に見つかった内容を並べて表示されます。
合格した実行の信頼度レポート: 上部に判定、その下にすべてのステップとアサーション、下端に実行の動画。 - 6
ビルドのたびに実行する
ビルドマシンでは、gtr-cli がビルドのたびにテストを実行します。注文が失敗するとビルドが失敗し、実行のレポート、動画、画像が残ります。
エンドツーエンドテストをビルドのたびに実行する
エンドツーエンドテストが注文を守れるのは、変更のたびに実行される場合だけです。ビルドマシンでは、gtr-cli がどの CI/CD ツールからでもテストを実行し、パイプラインが期待するとおりに答えます。
gtr-cli run tests\Order.GTS --countdown 0 --junit results\order.xml --artifacts results\artifacts- 注文が失敗すると、終了コードによってビルドが失敗します。結果ファイルの内容が、CI ツールのテストタブに表示されます。アーティファクトフォルダーには、実行の動画、信頼度レポート、失敗した箇所の画像が残ります。
ある朝注文が失敗したら、レポートには、失敗したステップ、期待した内容と実際に見つかった内容の対比、最後に合格した実行が示されます。テストレポートの読み方では最初に見るべき点を説明し、パイプラインでテストを実行するには CI ツールごとにすぐ使える例があります。
同じテストをほかのブラウザー、デバイス、アプリで
注文は、1 つのブラウザーで一度記録しました。Web アプリの場合、GUI Test Runner-Recorder は同じテストを Chrome、Edge、Firefox 向けと、エミュレートしたスマートフォンやタブレット向けに生成できます: 1 回の記録からのクロスブラウザーテストをご覧ください。
この記事の内容に、ショップや Web に限った話は 1 つもありません。記録する、検証する内容を選ぶ、実行する、レポートを読むという同じ 4 つの手順で、Windows デスクトップアプリ、コンピューターに接続した Android スマートフォン、ゲームのエンドツーエンドテストを作れます。コードを書かずに Windows デスクトップアプリをテストするでは、デスクトップの例を追っています。
始める前に知っておくこと
| 制限 | 意味 |
|---|---|
| テストは本当に支払う | テストは顧客と同じように「支払う」をクリックします。テスト環境で、テストカードを使って実行してください。 |
| 同じ開始状態 | テストは、記録したときの状態から再生されます。デスクトップアプリの場合は、実行のたびにアプリをその状態に戻してください。 |
| 実行は実際の画面を使う | 実行中はマウスとキーボードに触れないか、テスト用のビルドマシンを用意してください。Web テストは、ブラウザーウィンドウなしでも実行できます。 |
| テストは指示されたものだけを検証する | アサーションのない画面は、気づかれないまま変わることがあります。各ステップをアサーションで終えてください。 |
要点
- 1エンドツーエンドテストは、実際の画面を通してワークフロー全体を、ユーザーの最初のクリックから最終結果までたどります。
- 2部分どうしの受け渡しをカバーし、一度に 1 つの部分しか見ないテストには見えないものを捉えます。
- 3各ステップはアサーションで終え、注文番号のように変化する値は形式で検証します。
- 4数は少なく保ちます: 事業に欠かせないワークフローを、ビルドのたびに実行します。
- 5コードがなければ、維持のコストもなくなります。GUI Test Studio はワークフローを一度記録し、自動で再生します。
よくある質問
エンドツーエンドテストとは、簡単に言うと何ですか?
エンドツーエンドテストは、アプリケーションのワークフロー全体を、ユーザーがたどるとおりに、実際の画面を通して検証します。テストは最初のクリックから始まり、注文確認のような、ユーザーが求めていた結果で終わります。
エンドツーエンドテストの例には、どんなものがありますか?
ショップアプリでの注文が、代表的な例です。テストはサインインし、商品をカートに入れ、支払い、確認ページに正しい合計金額と注文番号が表示されることを検証します。これらの画面の裏側にあるすべての部分が連携して動いたときにだけ、合格します。
エンドツーエンドテストと機能テストの違いは何ですか?
機能テストは、割引コードの入力欄のような 1 つの機能を、あるべき動作と照らして検証します。エンドツーエンドテストは、多くの機能をまたぐワークフロー全体をたどります。エンドツーエンドテストは、対象を最も広く取った機能テストです。
エンドツーエンドテストと統合テストの違いは何ですか?
統合テストは、アプリケーションの 2 つ以上の部分が連携して動くことを、通常はコードを通して検証します。エンドツーエンドテストは、アプリケーション全体を画面を通して検証します。画面に誤った結果が表示されていても、統合テストは合格することがあります。
チームにはエンドツーエンドテストがいくつ必要ですか?
少数を、よく選んで用意します。まず、壊れたときに事業への影響が最も大きいワークフローを 1 つ選び、次にほかの欠かせないものを追加します。ほとんどのアプリケーションは、ビルドのたびに実行する 5 件から 15 件のテストで十分に守られます。
エンドツーエンドテストは UI テストと同じですか?
まったく同じではありません。UI テストは画面そのものを検証します: 要素がそこにあり、正しく見えることです。エンドツーエンドテストは、画面を使ってワークフロー全体をたどり、その結果を検証します。エンドツーエンドテストは、たいてい途中で UI の検証も行います。
エンドツーエンドテストは誰が書きますか?
従来は、テストがコードだったため、開発者や自動化エンジニアが書いてきました。テストをコードで書く代わりに記録するなら、ワークフローを知っているテスターやプロダクトオーナーが、自分で作成して保守できます。
エンドツーエンドテストは、コードを書かずに自動化できますか?
はい。GUI Test Studio では、記録しながらアプリケーションでワークフローを一度行い、テストが検証する内容を選びます。その後はテストがビルドのたびに自動で再生され、テストコードを書くことも保守することもありません。
Playwright、Selenium、Cypress、Claude、ChatGPT、Chrome、Edge、Firefox、Android、Windows は各所有者の商標です。


