テストカバレッジとは何か?

Question

テストカバレッジとは何か?

Accepted Answer

**テストカバレッジ**は、**テストによって実行されるコードの量**を測定します。通常はパーセンテージで表現されます（例：80%のカバレッジ）。テストされていないコードを見つけるのに便利なメトリクスですが、その制限を理解することが重要です。高いカバレッジは、必ずしも良いテストを保証するわけではありません。

## カバレッジが測定するもの

```text
TEST COVERAGE = the % of code exercised by the test suite:
  LINE coverage → % of code lines executed by tests
  BRANCH coverage → % of branches (if/else paths) taken
  FUNCTION coverage → % of functions called
  STATEMENT coverage → % of statements executed
→ Coverage tools instrument the code and report what tests do/don't exercise.
```

## カバレッジが有用な理由

```text
✓ FINDS UNTESTED code — low coverage areas reveal what lacks tests (a gap finder)
✓ A measurable quality signal; track it over time; many teams set a target (e.g. ≥80%)
✓ Highlights branches/paths/error cases that tests miss
```

## 制限事項（重要！）

```text
⚠️ HIGH COVERAGE ≠ GOOD TESTS:
  → coverage shows code was EXECUTED, NOT that behavior was correctly VERIFIED
  → you can execute code with NO meaningful assertions → 100% coverage, tests verify nothing
  → 100% coverage can still miss bugs (untested input combinations, logic errors)
⚠️ Chasing a coverage NUMBER → writing low-value tests just to hit the target
→ Coverage is a USEFUL guide (find gaps), NOT a guarantee of quality. Use it wisely;
  focus on testing important behavior well, not just hitting a percentage.
```

## なぜ重要なのか

テストカバレッジを理解すること（その制限を含めて）は価値があります。なぜなら、**一般的に使用されているメトリクス**であり、正しく理解すれば有用ですが、誤用されると誤解を招く可能性があるため、実践的な知識として重要だからです。

カバレッジは**テストによって実行されるコードの量**を測定します（パーセンテージで、行、分岐、関数、またはステートメントカバレッジを通じて）。これを理解することは有用です。なぜなら、**テストされていないコードを見つける**ことができるから（テストが不足している箇所を明らかにする — テスト対象が何かを特定するための貴重な方法）、チームが追跡できる測定可能な品質シグナルを提供し、見落とされた分岐とエラーケースをハイライトするからです。

多くのチームは、カバレッジを品質メトリクスとして目標値を設定して使用しています。

しかし、**制限事項を理解することは極めて重要です**：**高いカバレッジは、良いテストと同じではありません** — カバレッジはコードが*実行された*ことを示していますが、その振る舞いが正しく*検証された*ことを示していません。したがって、意味のないテスト（コードを実行しているが適切なアサーションを行わないテスト）で高いカバレッジ（100%でさえ）を持つことができます。また、完全なカバレッジでも、バグを見落とす可能性があります（テストされていない入力の組み合わせ、ロジックエラー）。

**カバレッジ数値を追い求める**危険性（単にターゲットに達するために低価値のテストを書くこと）は、実際のアンチパターンです。

**カバレッジはギャップを見つけるための有用なガイドであり、品質の保証ではない** — そして重点は、パーセンテージに到達するのではなく、重要な振る舞いを良くテストすることにあるべき、という理解は、カバレッジを目標としてではなくツールとして扱う一般的な誤りを避ける、成熟した判断を反映しています。

カバレッジは、広く使用されているメトリクスであり、実際に有用です（テストされていないコードを見つける）が、一般的に誤解され、誤用されています（品質保証またはゲーム化するターゲットとして扱われている）。その価値と重要な制限の両方を理解することで、それを賢く使用できるようになるため、テストカバレッジを理解することは価値があり、実践的に関連する知識です — 正しく理解すべき有用なメトリクスであり、その制限を理解すること（カバレッジ≠品質）はメトリクス自体と同じくらい重要であり、健全なテスト判断を反映しています。