コードカバレッジ

IntelliJ IDEA のコードカバレッジを使用すると、特定の実行中に実行されたコード行を分析できます。これにより、テストでカバーされたコードの割合を決定し、テストカバレッジが不十分な領域を特定できます。

コードカバレッジ for Java プラグインを有効化

この機能は、デフォルトで IntelliJ IDEA にバンドルされ有効になっている Code Coverage for Java プラグインに依存しています。関連機能が利用できない場合は、プラグインを無効化していないことを確認してください。

Ctrl+Alt+S を押して設定を開き、プラグインを選択します。
インストール済みタブを開き、 Java のコードカバレッジプラグインを見つけて、プラグイン名の横にあるチェックボックスを選択します。

カバレッジ付き実行

カバレッジ分析を実行するためのエントリポイントは、通常アプリケーションを実行するために使用するものと同じです。

メインメソッドの定義については、エディターのガターで実行をクリックし、 Run with Coverage を選択します。
実行構成の場合は、実行ウィジェットでその他のアクションをクリックし、 Run with Coverage を選択します。
Gradle タスクの場合は、 Gradle ツールウィンドウに移動し、タスクを右クリックして Run with Coverage を選択します。

カバレッジ分析は、カバレッジエージェントが接続された対応する実行構成を実行します。このエージェントはバイトコードをインストルメント化して、実行を行ごとに追跡します。実行が完了すると、分析の結果が IDE に表示されます。

カバレッジスイート

カバレッジ suite は、特定の実行から得られたコードカバレッジデータの集合です。各カバレッジ suite には、単一の実行構成（カバレッジ付きで実行の場合）またはインポートしたカバレッジデータファイルのいずれかのデータが保存されます。

IntelliJ IDEA は coverage フォルダーの IDE システムディレクトリにカバレッジ suite を保存します：

%LOCALAPPDATA%\JetBrains\IntelliJIdea%instance-version%\coverage

~/Library/Caches/JetBrains/IntelliJIdea%instance-version%/coverage

~/.cache/JetBrains/IntelliJIdea%instance-version%/coverage

IntelliJ IDEA では複数のカバレッジ suite の結果を同時に表示でき、表示する suite を選択できます。複数の suite が選択されている場合、IDE ではそれらの合成結果を表示します。つまり、いずれかの suite で実行された行はカバレッジされているとみなされます。

表示するカバレッジ suite を選択

メインメニューで、実行 | カバレッジレポートの管理… (Ctrl+Alt+F6) に移動します。
開いた表示するカバレッジスイートの選択ダイアログで、結果を表示したい suite を選択してください。
- すべてのコードカバレッジ結果を非表示にしたい場合は、代わりにカバレッジなしをクリックしてください。これにより、すべてのカバレッジ suite の選択が解除され、ダイアログが閉じられます。
選択対象の表示をクリックします。

IntelliJ IDEA でコードカバレッジ結果を読み込み、カバレッジツールウィンドウを開きます。

カバレッジ suite の追加と除去

IntelliJ IDEA 以外で生成されたファイル（例：ビルドサーバーや他の開発者による）のコードカバレッジ結果を確認したい場合は、そのファイルを別のカバレッジ suite として追加できます。これは、 JaCoCo （ .exec または .xml ）や IntelliJ IDEA runner（ .ic ）で生成されたファイルに適用されます。

IDE から suite を除去したり、ディスクから完全に削除することもできます。

メインメニューで、実行 | カバレッジレポートの管理… (Ctrl+Alt+F6) に移動します。
開いた表示するカバレッジスイートの選択ダイアログで、ツールバーからアクションを選択してください：
- 外部カバレッジファイルをインポートするには、追加をクリックし、ファイルを閲覧してください。
- IDE からカバレッジ suite を除去してディスク上には保持する場合は、suite を選択し、除去をクリックしてください。
- IDE とディスクの両方からカバレッジ suite を削除するには、suite を選択し、削除をクリックしてください。

カバレッジデータを読み取る

IntelliJ IDEA は、次のカバレッジ結果を表示します:

カバレッジツールウィンドウ
プロジェクトツールウィンドウ
エディター

コードカバレッジの結果は、カバレッジを含む実行構成を少なくとも 1 つ起動すると、カバレッジツールウィンドウ、プロジェクトツールウィンドウ、およびエディターに表示されます。

プロジェクトツールウィンドウ

プロジェクトツールウィンドウには以下が表示されます。

ディレクトリのカバークラスと行の割合
カバーされているメソッドとクラスの行数の割合

カバレッジツールウィンドウ

レポートでは、クラス、メソッド、行、ブランチのカバレッジ率別にプロジェクトを分類します。

ブランチカバレッジは、 if-else や switch などのステートメントで実行されたブランチの割合を示します。これは、JaCoCo ランナーと、分岐カバレッジオプションが有効になっている IntelliJ IDEA ランナーで使用できます。

カバレッジツールウィンドウには次のオプションがあります。

項目	説明
	パッケージを階層的に表示するか、構造をフラット化してすべてを同じレベルで表示するかを選択します。
	このオプションがオンの場合、IntelliJ IDEA は選択したアイテムをエディターで自動的に開きます。それ以外の場合は、項目をダブルクリックして開く必要があります。
	このオプションがオンの場合、IntelliJ IDEA は、エディターで開いたファイルをツールウィンドウで自動的に検索します。
	コードカバレッジレポートを生成し、指定したディレクトリに保存します。詳細については、カバレッジレポートの生成を参照してください。
	ディスクからカバレッジスイートをインポートします。
	カバレッジ結果をフィルタリングします。以下のフィルターを設定できます。変更されたクラスのみを表示 – 保護された VCS ブランチに相対して、現在の機能ブランチで変更されたクラスのみを表示します。このオプションでは、フィーチャブランチにコミットされた変更が必要です。リモート VCS ブランチにまだ適用されていないアップデートに焦点を絞るには、このオプションを選択します。保護されているリモート VCS ブランチが少なくとも 1 つ存在する場合に有効になります。コミットされていない変更のあるクラスのみを表示 – VCS にコミットされていないクラスのみを表示します。変更されたクラスのみを表示が利用可能な場合、このオプションは表示されません完全にカバーされたクラスを非表示にする – テストで完全にカバーされていないクラスのみを表示します。通常は完全にカバーされている要素や、インターフェースなどの実行可能な行が含まれていない要素を除外する場合は、このオプションを選択します。

エディター

エディターでは、個々のコード行のカバレッジステータスが表示されます。ステータスはガターに色分けされたマーカーで示されます：

緑（）：コード行が実行されました。
黄（）：コード行が部分的に実行されました。これは、コード行に条件付きロジック（if/else ステートメントやループ、 switch ステートメントなど）が含まれていて、一部のブランチしか実行されなかった場合に発生します。
赤（）：コード行は実行されませんでした。

特定の行のカバレッジ統計を表示するポップアップを開くには、ガター内のカバレッジマーカーをクリックしてください。使用したカバレッジ runner に応じて、ポップアップには異なる情報が表示されます：

IntelliJ IDEA runner の場合、ポップアップには次の情報が表示されます：

ヒット数：コード行が実行された回数。
行に条件付きロジック（if/else ステートメント、三項演算子またはループなど）が含まれている場合：
- 真のヒット数：条件が真になった回数。
- 偽のヒット数：条件が偽になった回数。
行に switch ステートメントが含まれている場合：
- case <値> ：特定の case が実行された回数。

JaCoCo runner の場合、ポップアップには次の情報が表示されます：

完全にカバー済み：コード行が実行されました。条件付きロジックを含む場合は、すべてのブランチが実行されました。条件付きロジックを含む場合、すべてのブランチが実行されました。
一部のみ実行済み：コード行は実行されたものの、条件付きロジックの一部ブランチしか実行されませんでした。
未カバレッジ：コード行はまったく実行されませんでした。
<number>/<number> 個のブランチをカバー済み：条件付きロジックのうち、実行されたブランチ数と全体のブランチ数の比率。

さらに、ポップアップには次のアイコンが含まれます：

前の <カバレッジステータス>

前のカバレッジマーカーに移動し、その統計を開きます。

次の <カバレッジステータス>

次のカバレッジマーカーに移動し、その統計を開きます。

テストがカバーする行を表示

そのコード行をカバーするテストを別のポップアップで表示します。

バイトコードの表示

現在のクラスのバイトコードを別のツールウィンドウで表示します。

カバレッジカラーを編集

設定 | エディター | カラースキーム | 全般を開き、カバレッジマーカーの色をカスタマイズします。

カバレッジを非表示

IntelliJ IDEA でカバレッジ結果の表示を停止します。

カバレッジデータを非表示にする

次のいずれかを実行します。

カバレッジツールウィンドウ (表示 | ツールウィンドウ | カバレッジ) のカバレッジ統計のタブを閉じます。
ガター内のカバレッジハイライトをクリックし、カバレッジを非表示を選択します。

カバレッジレポートの生成

実行 | カバレッジレポートの生成に移動するか、カバレッジツールウィンドウでをクリックします。
このオプションは、カバレッジ付きの必要なテストを実行した後にのみ使用可能になります。
カバレッジレポートの生成ダイアログで、生成されたレポートを保存するディレクトリを指定し、オプションで生成した HTML をブラウザーで開くチェックボックスを選択します。