システム開発をしていると、「E2Eテスト」という言葉を耳にすることがあります。
「どこからどこまでテストするの?」「画面からE2Eテストする場合と、APIからE2Eテストする場合では何が違うの?」と疑問に思う方もいるのではないでしょうか。
この記事では、「E2Eテスト」について以下の内容をわかりやすく説明します。
- E2Eテストの意味
- E2Eテスト・単体テスト・結合テストの違い
- E2Eテストの特徴
- UIでのE2EテストとAPIでのE2Eテスト
E2Eテストとは?

E2E(End-to-End)テストとは、本番に近い環境で、ユーザーが実際にシステムを使うのと同じ手順で操作し、システム全体が正しく動いて期待した結果が得られるかを確かめるテストです。 「End-to-End」は「端から端まで」という意味です。サーバーでの処理、データベースの更新、必要に応じた外部サービスとの連携まで確認します。
例えば、画面で「注文する」を押すと、サーバーが注文を受け付け、データベースに保存します。クレジットカードで支払う場合は、外部の決済サービスとも連携します。E2Eテストでは、こうした処理がつながり、注文した内容を履歴で確認できるところまで確かめます。
マグカップを2個注文したのに、注文履歴には1個と表示されたとします。E2Eテストでは、2個選んで注文し、履歴にも2個と表示されるかを確かめるので、この不具合に気づけます。
テストの開始点は、確かめたい操作に合わせて決めます。注文から履歴までを確認するなら、ログイン済みの状態から始められます。ログインも確認するなら、ログイン画面から始めます。
E2Eテスト・単体テスト・結合テストの違い

E2Eテスト・単体テスト・結合テストの違いは、どこまで動かして確かめるかです。同じネットショップの注文を例にすると、次のように分けられます。
| テストの種類 | 確認する範囲 | ネットショップでの例 |
| 単体テスト | 関数などの小さな単位 | 合計金額を計算する関数に単価500円と数量2を渡すと、1,000円を返すか |
| 結合テスト | 複数の処理や機能のつながり | 注文処理が、商品と数量をデータベースに保存できるか |
| E2Eテスト | 操作の開始から期待した結果まで | 商品を2個注文し、注文履歴で2個と確認できるか |
このように、1つの処理の正しさ、処理同士のつながり、操作全体の結果を、それぞれのテストで確かめます。なお、結合テストとE2Eテストの呼び分けは、プロジェクトによって異なることがあります。名前だけでなく、どこからどこまで確認するのかをプロジェクトで共有することが大切です。
E2Eテストの特徴
E2Eテストには以下のような特徴があります。
- 確かめたい操作を実際に行える環境が必要
- E2Eテストでは、一連の操作を最後まで進めて結果を確かめます。その途中で使う機能が動いていないと、確認したい結果までたどり着けません。
- 例えば、注文画面を開けても、注文を保存するデータベースが止まっていれば、注文した内容を履歴で確認できません。そのため、注文の受付から履歴の表示までに使う機能を、本番に近いテスト環境で動かしておきます。
- テストを実行する環境ごとにデータを用意する必要がある
- 手元と自動テスト用の環境が別々のデータベースを使う場合、それぞれのテストは自分の環境にあるデータを使います。
- 例えば、手元のデータベースにマグカップを登録しても、自動テスト用のデータベースにも登録しなければ、その環境では注文できません。自動テスト用の環境にも商品と在庫を用意します。ログインが必要なら、その環境で使えるテスト用アカウントのIDとパスワードも用意します。
- 同じデータを使うテストは、同時に実行すると互いに影響することがある
- 同時に動くテストが同じデータを使うと、一方がデータを変更した時点で、もう一方のテストの条件が変わることがあります。
- 例えば、在庫が2個の商品を、2つのテストがそれぞれ2個ずつ注文すると、先に注文が通ったテストが在庫を使い切ります。もう一方は、在庫切れで注文できません。テストごとに別の商品を用意すると、在庫を取り合わずに実行できます。
- 次のテストに影響しないよう、データを片付けたり初期化したりする必要がある
- テストで作ったデータが残ると、次のテストを始める時点で、前回の結果が混ざってしまいます。
- 例えば、空の注文履歴に1件だけ注文が追加されることを確かめるテストでは、前回の注文が残っていると履歴が2件になります。テストが終わったら、その回に作った注文を削除して、履歴を空に戻します。
UIでのE2EテストとAPIでのE2Eテスト

WebアプリのE2Eテストには、「ブラウザの画面を操作する方法(UIでのE2Eテスト)」と「APIに直接リクエストを送る方法(APIでのE2Eテスト)」があります。APIでのE2Eテストでは、画面を含めず、APIを入口としてサーバー側の一連の処理を確認します。
ここからは、マグカップを2個注文する例を使って、それぞれの手順と特徴を説明します。
UIでのE2Eテスト
UI(ユーザーインターフェース)でのE2Eテストでは、利用者と同じように画面を操作し、表示された結果を確かめます。
例えば、ネットショップで「マグカップを2個注文し、その内容をあとから注文履歴で確認できるか」をテストする場合、次の手順で行います。
- ブラウザで、マグカップを2個カートに入れます。
- 注文画面で「注文する」を押します。
- 完了画面に注文番号が表示されることを確かめます。
- 注文履歴で同じ注文番号を探し、マグカップが2個と表示されることを確かめます。
画面の操作から結果の表示まで確認できるのが特徴です。 たとえば、注文処理そのものが正常でも、「注文する」ボタンを押して何も起きなければ、UIでのテストで気づけます。ただし、ブラウザの起動や画面の読み込みがある分、実行に時間がかかりやすく、ボタン名などが変わるとテストの修正が必要になる場合があります。
APIでのE2Eテスト
APIでのE2Eテストでは、テスト用のプログラムからAPIに直接リクエストを送り、期待した結果が得られるまでの流れを確かめます。
例えば、ネットショップで「マグカップを2個注文し、その注文をあとからAPIで取得できるか」をテストする場合、次の手順で行います。
- 注文作成APIに、マグカップの商品IDと数量「2」を送ります。
- 注文の作成が成功し、注文番号が返ることを確かめます。
- その注文番号を使って、注文取得APIに内容を問い合わせます。
- 返ってきた商品IDと数量が、最初に送った値と一致することを確かめます。
このテストでは、サーバーで注文を処理し、データベースに保存した内容をあとから取得できるところまで確認します。ボタンの操作や注文履歴の表示は、UIでのE2Eテストで確認します。
決済まで確かめる場合は、外部の決済サービスとの連携も確認します。決済サービスのテスト環境を使い、支払いが承認されて注文が「支払い済み」になることまで確かめます。
APIでのE2Eテストはブラウザの起動やページの読み込みがない分、同じ注文処理を短時間で確認しやすいのが特徴です。 ボタン名の変更や画面表示の遅れにも影響されにくくなります。
APIを呼び出すだけで、E2Eテストになるわけではありません。APIでのE2Eテストでは、例えば注文作成APIに商品と数量を送り、その注文がデータベースに保存され、注文取得APIから正しい内容を取得できるところまで、一連の流れを確認します。
UIでのE2EテストとAPIでのE2Eテストの違い
「UIでのE2Eテスト」と「APIでのE2Eテスト」の違いを下表に示します。
| 比較項目 | UIでのE2Eテスト | APIでのE2Eテスト |
| 操作の入口 | ブラウザで商品を選び、「注文する」ボタンを押す | 注文作成APIに商品IDと数量を送る |
| テストで通る範囲 | 画面の操作、サーバーでの注文処理、注文の保存・取得、画面への表示 | APIの呼び出し、サーバーでの注文処理、注文の保存・取得、APIの応答 |
| 結果の確認先 | 完了画面の注文番号と、注文履歴に表示された商品・数量 | 注文作成APIが返した注文番号と、注文取得APIが返した商品ID・数量 |
| 確かめたいこと | 利用者が画面から注文し、注文履歴で内容を確認できるか | APIから注文を作成し、その注文をあとから取得できるか |
| 見つけられる不具合の例 | 「注文する」ボタンが反応しない、注文履歴に違う数量が表示される | 作成に成功したはずの注文を取得できない、応答に違う数量が入っている |
| 実行時間 | ブラウザの起動や画面の読み込みがあるため、時間がかかりやすい | 画面の読み込みを待たずにAPIを呼ぶため、同じ注文処理なら短時間で確認しやすい |
| 画面変更の影響 | ボタン名で操作先を探している場合、名前が変わるとテストの修正が必要になることがある | APIの仕様が同じなら、ボタン名や画面の見た目が変わっても影響を受けにくい |
この違いは、見つけられる不具合にも表れます。たとえば、注文は正しく保存され、APIも「2個」と返しているのに、注文履歴には「1個」と表示されるとします。この場合、UIでのテストは失敗しますが、APIでのテストは成功します。APIの応答だけでは、その内容が画面に正しく表示されているかまではわからないからです。
注文そのものが保存されなかった場合は、どちらのテストでも気づけます。 UIでは注文履歴に表示されず、APIでは注文を取得できないからです。
本記事のまとめ
この記事では、「E2Eテスト」について、以下の内容を説明しました。
- E2Eテストでは、本番に近い環境で、ユーザーが実際にシステムを使うのと同じ手順で操作し、システム全体が正しく動いて期待した結果が得られるかを確かめるテストである。
- 実行する環境ごとにアカウントや在庫を用意し、テストで作ったデータは実行後に片付ける。
- UI経由では、利用者が画面から操作し、期待した結果を画面で確認できるかを確かめる。
- API経由では、APIに依頼を送り、保存や取得などの必要な処理が期待どおりに動くかを確かめる。
お読みいただきありがとうございました。