テストの種類を比べる——単体・E2E・目視確認をどこに使うか
テストは「全部に書く」か「書かない」かではなく、壊れたときの痛さと確かめる手間の釣り合いで置き場所を決めると続けやすくなります。単体テスト・E2Eテスト・目視確認を費用対効果の目線で並べます。
テストの種類は、壊れたときの痛さと確かめ続ける手間の釣り合いで選ぶ、というのが私の今の考え方です。計算や変換のように入力と出力がはっきりした部分は単体テスト、問い合わせ送信や購入のように「通らないと困る道筋」はE2Eテスト、見た目や文言の違和感は目視確認。どれか1つで全部を守ろうとすると、書く手間か見落としのどちらかが膨らみます。AIに書かせたコードをどう守るかは別の記事で、公開直前の確認項目はリリース前チェックリストの記事で書いたので、ここでは「どの種類にどれだけ手間をかけるか」に絞ります。
3種類を並べた比較表
| 確かめられること | 書く・保つ手間 | 向いている場所 | |
|---|---|---|---|
| 単体テスト | 関数や部品が決めた通りに動くか | 小さい。速く何度でも回せる | 料金計算、日付の整形、入力チェック |
| E2Eテスト | 画面を操作して最後まで通れるか | 大きい。画面の変更で直しが出やすい | 問い合わせ送信、ログイン、購入の流れ |
| 目視確認 | 見た目・文言・違和感 | 毎回人の時間がかかる | デザインの崩れ、画像、トーン |
この並べ方の土台には、よく知られた「テストピラミッド」の考え方があります。Martin Fowler氏の解説では、Mike Cohn氏が著書『Succeeding with Agile』で示したもので、画面を通す広い範囲のテストより、低いレベルの単体テストを多く持つのがよいと説明されています。同じ記事では、上の層のテストが遅く壊れやすいことが前提になっている、とも書かれています。私はこれを「比率の正解」ではなく「手間のかかり方の目安」として使っています。
単体テスト:ロジックが1か所にまとまっているとき
単体テストが効くのは、入力を渡せば出力が決まる部分です。たとえば税込価格の計算や、日付を「2026年11月14日」に整える処理。こうした関数は画面を開かなくても確かめられるので、テストは短く、何十本あっても数秒で回ります。
例としてVitestを挙げると、公式ガイドではViteを土台にしたテストフレームワークと説明されていて、ファイル名に .test. や .spec. を含めたものがテストとして扱われます。ツールは何であれ、ディレクターとして気にしているのは「テストを書きやすい形にロジックが切り出されているか」です。計算が画面のコードに埋もれていると、単体テストが書けず、確認がすべて目視に寄っていきます。
E2Eテスト:止まると困る道筋を少数だけ
E2Eテストは、ブラウザを実際に動かして、ページを開き、入力し、送信し、完了画面が出るところまでを確かめます。Playwrightの公式ドキュメントでは、Chromium・WebKit・Firefoxで動かせると説明されています。
手間がかかるのは、画面の構造や文言を変えるたびにテスト側も直す必要が出やすいことです。だから私は「全画面に書く」のではなく、止まったら売上や問い合わせが途切れる道筋だけに絞ります。問い合わせフォームなら「必須項目を入れて送ると完了画面が出る」の1本から始め、増やすのは実際にそこで困ったときにしています。
目視確認:人にしか判断できないもの
余白の崩れ、画像の切れ方、文言のトーンは、自動テストでは判断しにくい領域です。ここは人が見るしかないので、見る場所と見る端末を決めておくことで手間を抑えます。私はトップ・一覧・詳細・フォームのように「型」ごとに1ページずつ、スマホとPCで見る、という範囲を先に決めています。
目視確認で同じ不具合を2回見つけたら、それは自動化を検討する合図にしています。人が毎回見ている項目のうち、機械でも判定できるものを下の層に移していくと、目視の時間を本当に人が見るべき部分に残せます。
手間のかけ方を決めるときの問い
- ここが壊れたら、誰がどれくらい困るか
- 入力と出力がはっきりしているか(はっきりしていれば単体テスト向き)
- 画面の変更はどれくらいの頻度で起きるか(多いほどE2Eの維持が重い)
- 目視で見る範囲を、ページの型と端末で絞れているか
カバレッジ(テストが通ったコードの割合)の数値目標は、案件の性質で適切な値が変わると考えているので、私は先に決めず、上の問いで置き場所を決めてから結果として眺めるようにしています。
明日から試せる一手
いま担当しているサイトで「止まったら一番困る操作」を1つだけ書き出してください。それが単体・E2E・目視のどれで守られているかを確かめ、どれでも守られていなければ、まず目視確認の手順として1行で残します。そこから自動化するかどうかを決めると、テストの手間が痛さの大きい順に積み上がっていきます。