Skip to content

Use Vitest for Test Runner

コンテキスト

モダンなJavaScript/TypeScriptアプリケーション開発において、効率的で高速なテスト実行環境は開発品質と生産性向上のために不可欠である。特にViteをビルドツールとして採用するプロジェクトでは、ビルド設定との一貫性とテスト実行速度が重要な要素となる。

従来のJestは広く普及しているが、ESModulesサポートの複雑さやViteとの設定重複、起動時間の遅さなどの課題を抱えている。また、TypeScript環境でのセットアップの煩雑さも開発体験を損なう要因となっている。現代的な開発環境に適したテストランナーの選択が求められている。

決定事項

テストランナーとしてVitestを採用する。

選択肢

選択肢1: Vitest

利点:
- Viteとの完全な統合による設定の統一化
- ESModulesネイティブサポート
- TypeScriptの標準サポート（追加設定不要）
- 高速なテスト実行とHMR（Hot Module Replacement）
- JestライクなシンプルなAPI
- ウォッチモードによるインクリメンタルテスト
- 並列テスト実行による高速化
- Vite設定の自動継承
- 豊富なアサーションライブラリ内蔵
欠点:
- 比較的新しいツールのため情報リソースが限定的
- Jestエコシステムの一部プラグインとの互換性問題
- 大規模プロジェクトでの実績が少ない
- Node.js環境専用（ブラウザテストは別ツール必要）

選択肢2: Jest

利点:
- 広く普及した成熟したテストランナー
- 豊富なドキュメントとコミュニティサポート
- 多様なプラグインエコシステム
- スナップショットテスト機能
- コードカバレッジレポート内蔵
- ブラウザ環境シミュレーション（jsdom）
欠点:
- ESModulesサポートの複雑な設定
- TypeScript使用時の追加設定とビルド時間
- 起動時間の遅さ
- Viteとの設定重複による管理負荷
- CommonJS中心の設計による制約

選択肢3: Mocha + Chai

利点:
- 柔軟なテストフレームワーク構成
- アサーションライブラリの選択自由度
- 豊富なレポーター選択肢
- 軽量な基本構成
欠点:
- 複数ライブラリの組み合わせによる設定複雑性
- モックライブラリの別途導入必要
- TypeScript環境での追加設定負荷
- 統合的な開発体験の欠如

選択肢4: AVA

利点:
- 並列テスト実行による高速化
- ESModules標準サポート
- TypeScript標準対応
- シンプルなAPI設計
欠点:
- 限定的なコミュニティサイズ
- プラグインエコシステムの不足
- 学習リソースの少なさ
- Viteとの特別な統合機能なし

結果

この決定による影響を記述する。

ポジティブな影響:
- Vite設定の自動継承による設定コストの削減
- TypeScript環境での即座のテスト実行
- 高速なテスト実行による開発フィードバックループの短縮
- ESModulesネイティブサポートによる設定複雑性の排除
- ウォッチモードによるTDD開発スタイルの促進
- Viteエコシステムとの一貫した開発体験
ネガティブな影響:
- Jestから移行時の学習コスト発生
- 既存Jestプラグインの移行困難
- 新しいツールへの依存リスク
リスク:
- Vitestプロジェクトの将来的な継続性
- 大規模プロジェクトでの未知のパフォーマンス問題
- Jestエコシステムとの互換性問題
- チーム内でのテストツール知識の分散

参考資料