テスト戦略
テストはカバレッジの数字を稼ぐためではなく、実際の振る舞いを検証するために書く。
テストを追加する前に、どの障害を検出するためのテストかを明確にすること。
優先するのは次の対象である。
- 中核となるビジネスロジック
- 重要なユーザーの振る舞い
- 障害が発生しやすいことが分かっている経路
- 境界条件
- エラー処理
- 例外的な状況
- 統合の境界
カバレッジの数値は参考になるが、それ自体が目的ではない。目的は、重要な振る舞いが正しく動くと確信できることにある。
フロントエンドの E2E テスト
フロントエンドプロジェクトでは、可能な範囲で E2E テストを設けること。
E2E テストの対象は次のとおりである。
- 主要なユーザーフロー
- 重要なプロダクトの振る舞い
- 重要な統合の振る舞い
実際の利用に近いテストデータを使うこと。本番に近いデータが有効な場合は、事前に匿名化またはサニタイズし、本番環境の機密情報をテストフィクスチャに絶対に含めないこと。
E2E テストの実行時間は短く保つこと。テストを追加する際は、得られる検証の効果が品質ゲートの実行時間の増加に見合うか確認する。
Playwright を使うプロジェクトでは、jsPlugins 配列を介して eslint-plugin-playwright を oxlint に読み込むこと。このプラグインは oxlint との適合性テストを公式に受けている。oxlint の JS プラグインサポートは現在アルファ版である。
overrides エントリでルールの適用範囲を Playwright のテストファイルに限定し、アプリケーションコードに適用されないようにすること。
// .oxlintrc.json
{
"jsPlugins": ["eslint-plugin-playwright"],
"overrides": [
{
"files": ["e2e/**/*.ts"],
"rules": {
"playwright/no-networkidle": "error",
"playwright/no-wait-for-timeout": "warn",
},
},
],
}
フロントエンドのユニットテスト
フロントエンドプロジェクトでは、可能な範囲で重要なコンポーネントとロジックにユニットテストを書き、テストの質が高まる場合はサニタイズ済みの現実的なデータを使うこと。
優先するのは次の対象である。
- 重要なコンポーネントの振る舞い
- ビジネスロジック
- 状態遷移
- データ変換
- エッジケース
- エラーが発生する条件
ユニットテストは高速に保つこと。
実装の詳細をそのまま再現するだけのテストを避けること。