Vitest / Jest を採用する理由

VitestとJestは、JavaScriptやTypeScriptで書いたコードを、関数や画面部品といった小さな単位で自動的に検証する「単体テスト」のためのツールです。「この入力ならこの結果になるはず」という期待をテストとして書いておき、コードを変更するたびに実行して、期待どおりに動き続けているかを確認します。Jestは長く使われてきた定番のツールで、VitestはViteというビルドツールと同じ仕組みで動く、より新しいツールです。書き方はほぼ共通しており、どちらもTypeScriptや画面部品のテストに対応しています。

弊社では、TypeScriptで開発する案件の単体テストにVitestを、既存のプロジェクトや構成上の理由がある場合にはJestを採用しています。テストの対象は、金額計算や日付の扱い、入力チェックといった業務ルールを担う関数、APIの応答を整形する処理、Reactの画面部品の表示と振る舞いなどです。要件定義で決めた業務ルールをテストとして書き残すことで、ルールが仕様書とコードの両方に残り、将来の改修で意図せず変わってしまうことを防げます。Playwrightによる画面全体のテストとは役割を分け、細かなルールの検証は単体テストで速く網羅し、主要な操作の流れをE2Eテストで確認する組み合わせにしています。GitHub Actionsで変更のたびに実行し、問題があれば取り込む前に検出しています。PHPの案件では同じ役割をPHPUnitやPestが担っており、技術構成にかかわらず同じ考え方で品質を確保しています。

単体テストはコードと一緒に保守するもので、仕様変更の際はテストも合わせて更新します。テストが多すぎて実行に時間がかかると実行されなくなるため、業務ルールに関わる部分を優先し、実装の細部に依存しすぎないテストを心がけます。VitestやJestの更新では設定の書き方が変わることがあり、TypeScriptやReactの更新と合わせて依存関係を棚卸しする時期に対応します。テストの網羅率を目標にするより、不具合が起きたら再発防止のテストを追加する運用のほうが、長期的には効果的です。