2026.10.28

目的に応じて単体・jsdom・実ブラウザ・実APIのテストを分ける

何を保証したいかを4つの観点で整理する、フロントエンドのテスト選択。

せっかくなので、E2E を含むフロントエンドのテストの判断基準もシェアします…!

テストを書くときは、まず「何を確認したいか」で単体テスト・コンポーネントテスト(jsdom)・E2E を分けるようにしています!

① ロジックの結果を確認したい → 単体テスト 入力値に対する計算結果、条件分岐、データの変換、バリデーションのルールそのものを確認したい場合です! 画面を表示しなくても確認できる場合、まずここでテストしています。 例:文字数が上限を超えたとき、入力値が無効と判定されるか

② ユーザー操作に対する画面の反応を確認したい → コンポーネントテスト(jsdom) 入力、クリック、エラー表示、ボタンの有効・無効など、コンポーネントの状態や表示を確認したい場合。 例:文字数が上限を超えた入力をしたとき、エラーメッセージが表示され、送信ボタンが押せなくなるか

同じバリデーションでも、ルール自体は単体テスト、画面の表示や操作への反応はコンポーネントテストという分け方をしています。 ただし jsdom ではレイアウトや実ブラウザ固有の挙動までは確認できないので注意です。

③ レイアウトや実ブラウザ固有の挙動を確認したい → E2E(API モックを使う場合もあり) 画面のレイアウト、ブラウザ上での操作、複数画面にまたがる遷移などを確認したい場合。 例:スマホ幅で操作ボタンが見切れずに表示され、クリックできるか

実ブラウザを使う場合でも、確認したいことによっては API をモックできます。毎回バックエンドまでつなぐ必要はないです。 ただ不用意にモックを挟むと、本来モックすべきでないテストまでモックする可能性が出るので、要注意です。

④ フロントからバックエンドまで実際につながることを確認したい → E2E(実 API) 認証して、画面を操作して、実 API を呼び、データが保存され、その結果が画面に反映される。 こうした全体がつながって初めて成立する、重要なユーザーシナリオを E2E で確認しています。また重要な異常系も対象にはしますが、入力値の細かなパターンや条件分岐は単体テストやコンポーネントテストに任せています。

まとめると、判断するときに見ているのは以下の4つです! ・ロジックだけで確認できるか ・画面の表示や操作まで確認する必要があるか ・実ブラウザで確認する必要があるか ・バックエンドまでつなぐ必要があるか

「何を保証するために、どこまで動かす必要があるか」でテストを選ぶのをオススメします!

https://x.com/suna_gaku/status/2115014173419810957

追記:「とりあえず E2E」をやめたら CI が 2 時間から 5 分になった話(Zenn)

「とりあえず E2E」をやめたら、CI が 2 時間から 5 分になった話、という記事を書きました!

個人開発している恋愛相談アプリ「Lovady」で、AI に書かせたテストをとりあえず E2E に入れ続けた結果…

  • Playwright の E2E が 5 ブラウザ分で 1,726 件
  • PR のたびに全件実行して、1 回 2 時間以上…
  • 3 日間で 25 回回して、成功したのは 1 回だけ

完全に開発のボトルネックになっていたので、Codex と一緒に見直しつつ、テストをどこに書くかの判断基準と、E2E を安全に減らしていく進め方を整理してまとめてみました!

もし興味があれば、ぜひご覧ください!

「とりあえず E2E」をやめたら、CI が 2 時間から 5 分になった話(Zenn)

https://x.com/suna_gaku/status/2116760105844883616