IntelliJ IDEA 2024.1 ヘルプ

テストの準備

IntelliJ IDEA は、JUnitSpockTestNG など、複数の Java テストフレームワークですぐに使用できます。

IDE では、必要なテストメソッドとともに、ソースコードから直接テストクラスを作成できます。ショートカットを使用して、テストクラスとソースコードを切り替えたり、複数のテストを実行したり、各テストの統計を表示したり、テスト結果をファイルにエクスポートしたりできます。

IntelliJ IDEA はコードカバレッジも備えており、コードを分析して、コードのどの領域がテストの対象であり、どの領域にさらにテストが必要かを理解できます。

他の言語でのコードのテストの詳細については、以下を参照してください。

テストライブラリを追加する

IntelliJ IDEA を使用すると、コーディング中に不足しているライブラリを追加できます。プロジェクトにまだ追加されていないライブラリのコードを使用していることが IDE によって検出されると、それをダウンロードしてインストールするように求められます。

Adding a missing library via quick-fix

プロジェクトにライブラリを手動で追加することもできます。例: これは、特定のライブラリバージョンまたはディストリビューションが必要な場合に役立ちます。

テストライブラリを手動で追加する

ネイティブ IntelliJ IDEA ビルダーでプロジェクトをビルドする場合は、以下の手順に従ってライブラリを追加します。

  1. メインメニューで、ファイル | プロジェクト構造 (Ctrl+Alt+Shift+S) に移動します。

  2. プロジェクト設定ライブラリを選択し、the New Project Library button | Maven からをクリックします。

  3. 開いたダイアログで、必要なライブラリアーティファクトを指定します(例: org.junit.jupiter:junit-jupiter:5.9.1)。

  4. 変更を適用し、ダイアログを閉じます。

    Manually adding a testing library to a project

IntelliJ IDEA を使用すると、コーディング時に不足しているライブラリを追加できます。IDE は、プロジェクトにまだ追加されていないライブラリのコードを使用していることを検出すると、ダウンロードするように求めます。この場合、IDE は必要な依存関係を pom.xml に自動的に追加します。

Adding a missing library via quick-fix

ライブラリをプロジェクトに手動で追加することもできます。例: これは、特定のライブラリバージョンまたはディストリビューションが必要な場合に役立ちます。

依存関係ツールウィンドウを使用してライブラリを追加する

プロジェクトで Maven を使用している場合は、次の手順に従います。

  1. pom.xml で、Alt+Insert を押して、依存を選択します。

  2. Maven アーティファクト検索ツールウィンドウで、必要な依存関係の名前を入力します (例: org.junit.jupiter:junit-jupiter)。結果のリストで必要なものを選択し、追加をクリックします。

    Adding a Maven dependency
  3. 依存関係が pom.xml に追加されたら、Ctrl+Shift+O を押すか、Maven ツールウィンドウで Reimport All Maven Projects をクリックして変更をインポートします。

Maven の操作の詳細については、「Maven 依存関係」を参照してください。

Gradle プロジェクトでは、必要な依存関係をビルドファイルに手動で追加します。

  1. build.gradle で、Alt+Insert を押して、Maven アーティファクト依存関係を追加を選択します。

  2. Maven アーティファクト検索ツールウィンドウで、必要な依存関係の名前を入力します (例: org.junit.jupiter:junit-jupiter)。結果のリストで必要なものを選択し、追加をクリックします。

    Adding a Maven dependency
  3. 依存関係が build.gradle に追加されたら、Ctrl+Shift+O を押すか、Gradle ツールウィンドウで Reimport All Gradle Projects をクリックして変更をインポートします。

テストソースルート

テストの作成を開始する前に、テストソースルートがプロジェクト用に構成されていることを確認してください。テストソースルートは、テストコードを保存するフォルダーです。プロジェクトツールウィンドウでは、このフォルダーには the Tests root icon テストルートアイコンが付けられます。

IDE は、さまざまなソースからのコードを異なる方法で処理します。例: ソースとテストソースのコンパイル結果は通常、異なるフォルダーに配置されます。そのため、テストソースのルートがない場合は、ルートを作成する必要があります。そうしないと、コードが正しく処理されない可能性があります。

プロジェクトのテストルートを作成する

ネイティブ IntelliJ IDEA ビルダーを使用してプロジェクトをビルドする場合は、次の手順に従います。

  1. プロジェクトツールウィンドウ(Alt+1)で、テストコードを保存する新しいディレクトリを作成します。

  2. 新しいディレクトリを右クリックして、ディレクトリをマーク | テストソースルートを選択します。

    テストフォルダーは the Tests root icon アイコンでマークされている必要があります。

    Creating the test sources root

Maven は、アプリケーションに標準のディレクトリレイアウト(英語)を使用します。通常、プロジェクトではこのレイアウトに準拠することをお勧めします。例: Maven プロジェクト用に IntelliJ IDEA にテストフォルダーを作成する場合、IDE はそのようなフォルダーの標準名と場所を設定することを提案します。この場合、IDE は、このテストフォルダーがテストソースルートであることもすでに認識しています。

ただし、ビルドファイルを変更することで、標準のディレクトリレイアウトを上書きできます。

テストルートを変更する

  1. プロジェクトツールウィンドウ(Alt+1)で、テストコードを保存する新しいディレクトリを作成します。

  2. pom.xml で、testSourceDirectory 要素を変更します。

    src/new-test/test を、テストルートとして使用する新しいフォルダーへのパスに置き換えます。

    <build> <testSourceDirectory>src/new-test/test</testSourceDirectory> </build>
  3. Ctrl+Shift+O を押すか、Maven ツールウィンドウで Reimport All Maven Projects をクリックして変更をインポートします。

新しいテストルートは、プロジェクトツールウィンドウで the Tests root icon アイコンでマークされている必要があります。

Maven と同様に、Gradle にも厳密なプロジェクトディレクトリレイアウトがあります(英語)。Gradle プロジェクト用に IntelliJ IDEA にテストフォルダーを作成する場合、IDE はそのようなフォルダーの標準の名前と場所を設定することを提案します。この場合、IDE は、このテストフォルダーがテストソースルートであることもすでに認識しています。

ただし、ビルドファイルを変更することで、標準のディレクトリレイアウトを上書きできます。

別のテストルートを使用する

  1. プロジェクトツールウィンドウ(Alt+1)で、テストコードを保存する新しいディレクトリを作成します。

  2. build.gradle を開き、次のコードを追加します。

    src/new-test/test を、テストルートとして使用する新しいフォルダーへのパスに置き換えます。

    sourceSets { test { java { srcDirs = ['src/new-test/test'] } } }
  3. Ctrl+Shift+O を押すか、Gradle ツールウィンドウで Reimport All Gradle Projects をクリックして変更をインポートします。

テストルートをもう 1 つ追加する

  1. プロジェクトツールウィンドウ(Alt+1)で、テストコードを保存する新しいディレクトリを作成します。

  2. build.gradle を開き、次のコードを追加します。

    src/new-test/test を、テストルートとして使用する新しいフォルダーへのパスに置き換えます。

    sourceSets { test { java { srcDir 'src/new-test/test' } } }
  3. Ctrl+Shift+O を押すか、Gradle ツールウィンドウで Reimport All Gradle Projects をクリックして変更をインポートします。

新しいテストルートは、プロジェクトツールウィンドウで the Tests root icon アイコンでマークされている必要があります。

さまざまなタイプのフォルダーの詳細については、「フォルダーのカテゴリ」を参照してください。

テストリソースルート

テストリソースルートは、テストソースに関連付けられたファイルを格納するフォルダーです。プロジェクトツールウィンドウでは、このフォルダーはテストルートにあり、Test Resources Root icon とマークされています。

Maven および Gradle プロジェクトの場合、通常、テストリソースフォルダーは自動的に作成されます。ネイティブ IntelliJ IDEA ビルダーでプロジェクトをビルドしている場合は、リソースルートを手動で作成する必要がある場合があります。

テストリソース用のフォルダーを構成する

  1. メインメニューで、ファイル | プロジェクト構造 (Ctrl+Alt+Shift+S) に移動します。

  2. プロジェクト設定で、モジュールをクリックし、右側のソースタブを開きます。

  3. テストフォルダーを右クリックして、新規フォルダーを選択します。フォルダーに resources という名前を付けます。

  4. 新しいフォルダーを右クリックして、テストリソースを選択します。フォルダーは Test Resources Root icon アイコンでマークされます。

  5. 変更を適用し、ダイアログを閉じます。

    Test Resources Root created in the Project Structure dialog

関連ページ:

JUnit 5

このチュートリアルでは、プロジェクト用に JUnit をセットアップし、テストを作成し、実行して、コードが正しく動作しているかどうかを確認する方法を学習します。それは始めるための基本的なステップだけを含んでいます。JUnit について詳しく知りたい場合は、公式ドキュメントを参照してください。IntelliJ IDEA のテスト機能の詳細については、このセクションの他のトピックを参照してください。Maven、Gradle、IntelliJ ビルダーのいずれかを使用してチュートリアルに従うことを選択...

Spock 入門

Spock は、テストを自動化するために使用できる Java および Groovy コードのテストフレームワークです。IntelliJ IDEA は、完全な Spock 統合と、スポックフレームワークの機能強化、スポック ADB などのサードパーティプラグインを介して有効にできる追加の Spock 機能をサポートします。プロジェクトの作成:Spock フレームワークがどのように機能するかを確認するには、通常の Gradle プロジェクトを作成します。Spock のプロジェクトを作成する Intell...

TestNG

この記事から、プロジェクト用に TestNG をセットアップし、テストを作成し、実行してコードが正しく動作しているかどうかを確認する方法を学習します。それは始めるための基本的なステップだけを含んでいます。TestNG について詳しく知りたい場合は、公式ドキュメントを参照してください。IntelliJ IDEA のテスト機能の詳細については、このセクションの他のトピックを参照してください。Maven または Gradle を使用して、このページの手順に従うことを選択できます。プロジェクトに Tes...

コードカバレッジ

IntelliJ IDEA のコードカバレッジを使用すると、特定の実行中に実行されたコード行を分析できます。これにより、テストでカバーされたコードの割合を決定し、テストカバレッジが不十分な領域を特定できます。Java のコードカバレッジプラグインを有効にするこの機能は、デフォルトで IntelliJ IDEA にバンドルされ有効になっている Code Coverage for Java プラグインに依存しています。関連する機能が利用できない場合は、プラグインを無効にしていないことを確認してくださ...

JavaScript のテスト

IntelliJ IDEA を使用すると、Karma、Vitest、Jest、Protractor、Cucumber.js、Mocha、Node.js テストランナーを使用して JavaScript ユニットテストを実行およびデバッグできます。テスト結果はツリービューで確認でき、そこからテストソースに簡単に移動できます。テストのステータスは、エディターのテストの隣に表示され、すぐに実行またはデバッグするオプションがあります。Jest、Karma、Mocha については、IntelliJ IDEA...

Node.js のテスト

IntelliJ IDEA を使用すると、多数のフレームワークを使用して Node.js アプリケーションをテストできます。現在のページでは、非同期テストシナリオの実行に特に役立つ JavaScript テストフレームワークである組み込みの Node.js テストランナーまたは Mocha を使用したテストについて説明します。IntelliJ IDEA の外部から Mocha テストを実行し、ツリービューに配置されたテスト結果を調べ、そこからテストソースに簡単に移動できます。IntelliJ IDE...