カバレッジの計測

「どこまでテストが到達しているか」を数値で見えるようにする指標がカバレッジです。テストが薄い領域を特定するのに役立ちます。

1. カバレッジ取得の意義

「どこまでテストが到達しているか」を数値で見えるようにする指標がカバレッジです。テストが薄い領域を特定するのに役立ちます。

2. 実行

-coverオプション付きでgo testを実行します。

go test -cover

以下のような実行結果が表示されます(数値はテストの充実度に依存します)。

PASS
coverage: 100.0% of statements
ok  	testdemo	0.002s

coverage: の行にステートメントベースのカバレッジ率が表示されます。ここでは 100% になっています。

3. HTMLでの詳細確認

カバレッジ情報をファイルに書き出し、HTMLで可視化できます。まずカバレッジプロファイルをファイルに保存します。

go test -coverprofile=coverage.out

以下のような実行結果が表示されます。

PASS
ok  	testdemo	0.002s

コマンド自体の出力は通常のテスト実行と同じですが、実行と同時にカレントディレクトリに coverage.out が生成されています。次に、そのファイルをHTMLで表示します。

go tool cover -html=coverage.out

ブラウザが自動的に開き、「テストが通ったコード」が緑、「通っていないコード」が赤で表示されます。どの分岐がテストに含まれていないかが視覚的に分かります。