ツイートシェアはてブ LINE Pocket

実行 / デバッグ構成: JUnit

JUnit 実行 / デバッグ構成は、JUnit テストフレームワークに基づくユニットテストの実行方法を定義します。

新しい JUnit 実行構成を作成する

メインメニューで、実行 | 実行構成の編集に移動します。
実行 / デバッグ構成ダイアログで、ツールバーのをクリックするか、Alt+Insert を押します。
リストには、実行 / デバッグ構成テンプレートが表示されます。JUnit を選択します。
右側に、構成オプションが表示されます。

名前

実行構成の名前を指定して、編集または実行時に他の構成の間ですばやく識別できるようにします。

実行

構成を実行するターゲット環境を選択します。アプリケーションをローカルで実行するほかに、SSH 経由でリモートマシン上で実行するか、Docker コンテナーで実行するかを選択できます。詳細については、ターゲットの実行を参照してください。

プロジェクトファイルとして保存

他のチームメンバーと共有できるファイルに実行構成設定を保存します。デフォルトの場所は .idea/runConfigurations です。ただし、.idea ディレクトリを共有したくない場合は、構成をプロジェクト内の他のディレクトリに保存できます。

デフォルトでは、このオプションは無効になっており、IntelliJ IDEA は実行構成設定を .idea/workspace.xml に保存します。

必須オプション

項目	説明
JRE	IntelliJ IDEA がアプリケーションの実行に使用するランタイム環境を指定します。デフォルトでは、IntelliJ IDEA はモジュールの依存関係から利用可能な最新の JDK を使用します。
モジュールのクラスパスを使用	アプリケーションの実行にクラスパスを使用する必要があるモジュールを選択します。
テスト種類	このリストから、テストの範囲を選択し、選択内容に応じてフィールドに入力します。パッケージ内すべて : パッケージ内のすべての単体テストを実行します。右側のフィールドでパッケージを指定します。ディレクトリ内すべて : ディレクトリですべての単体テストを実行します。右側のフィールドにディレクトリを指定します。パターン : テストクラスのセットを実行します。このセットには、同じまたは異なるディレクトリ、パッケージ、モジュールにあるクラスが含まれる場合があります。正規表現を使用して必要なクラスを指定します。このフィールドの各クラスは、完全修飾名で表す必要があります。クラス名は `\|\|` で区切る必要があります。クラス名を手動で入力するか、右側のをクリックして（または `Shift+Enter` を押して）、開いたダイアログで追加するクラスを検索できます。例: 名前に `IT` が含まれるすべての統合テストを除外する場合は、`^(?!.IT.).*$` と入力します。スイートテスト、つまり一緒に実行される複数のテストクラスのバンドルを作成することもできます。スイートテストクラスを作成するには、右側のをクリックし、スイートとして実行するテストクラスを入力します。その結果、`@Suite` アノテーションを使用して新しいクラスが作成されます。クラス : クラス内のすべての単体テストを実行します。右側のフィールドにクラスの完全修飾名を指定します。メソッド : 個々のテストメソッドを実行します。このメソッドを持つクラスの完全修飾名と、右側のフィールドにメソッド名を指定します。カテゴリ : カテゴリ(英語)内のすべてのテストを実行します。右側のフィールドでカテゴリを指定します。 UniqueId : テストスコープに特定の ID を持つテストとコンテナーを含めます。右側のフィールドに ID を指定します。タグ : (JUnit 5) テストスコープで `@Tag` アノテーションでタグ付けされたクラスとメソッドを実行します。タグ式は、次の許可された演算子を使用したブール式です: `!` (not)、`&` (and)、`\|` (or)。括弧を使用して、演算子の優先順位を調整できます。詳細と例については、JUnit5 のドキュメント(英語)を参照してください。
作業ディレクトリ	アプリケーションの実行に使用する作業ディレクトリを指定します。このディレクトリは、すべての相対入力および出力パスの開始点です。デフォルトでは、作業ディレクトリはプロジェクトルートです。

その他のオプション

JUnit テストフレームワークに基づく単体テストを実行する方法の詳細なオプションを表示するには、実行 / デバッグ構成ダイアログでオプションを変更を選択します。これにより、実行オプションの追加ダイアログが開きます。

オペレーティングシステム

項目	説明
複数のインスタンスを許可する	この実行構成の複数のインスタンスを同時に実行できるようにします。デフォルトでは、このオプションは無効になっています。つまり、構成を実行すると、構成の他のアクティブなセッションが終了します。
環境変数	をクリックして環境変数ダイアログを開き、そこで変数を作成してその値を指定できます。
入力をリダイレクト	テキストファイルから標準入力へのデータのリダイレクトを有効にします。スクリプトに何らかの入力が必要で、実行コンソールに値を入力する代わりに値を自動的に送信する場合は、このオプションを使用します。リダイレクトを有効にするには、チェックボックスを選択し、ターゲットテキストファイルへのパスを指定します。

Java

次のオプションは、Java コンパイラーとランタイムに固有のものです。

項目	説明
実行前にビルドしない	ビルドプロセスを開始せずに、すぐにテストを実行します。
クラスパスの変更	必要に応じて、別のクラスパスを指定するか、クラスパスから除外する依存関係を選択します。このオプションは、ランタイムクラスパスがコンパイルクラスパスと異なる場合 (デバッグライブラリ、別の場所など) に必要です。およびボタンを使用して、リストの依存関係を並べ替えます。依存関係の順序は重要です。IntelliJ IDEA は、リストで指定されている順序で依存関係を処理します。
“provided” スコープを持つ依存関係をクラスパスに追加する	指定されたスコープで依存関係をランタイムクラスパスに追加します。
コマンドラインを短縮	クラスパスが長くなりすぎる場合、または OS のコマンドラインの長さの制限を超える VM 引数が多数ある場合に、コマンドラインを短縮するために使用される方法を選択します。オプションの選択はクラスローダの実装に依存します。いくつかのフレームワークは JAR マニフェストをサポートしていませんが、カスタムクラスローダーを持つ他のフレームワークは classpath.file オプションでうまく動作しないでしょう。なし : IntelliJ IDEA は長いクラスパスを短縮しません。コマンドラインが OS の制限を超えると、IntelliJ IDEA はアプリケーションを実行できなくなり、短縮方法の指定を促すメッセージが表示されます。 JAR マニフェスト : IntelliJ IDEA は一時的な classpath.jar を介して長いクラスパスを渡します。元のクラスパスは、manifest ファイルで classpath.jar の `class-path` 属性として定義されています。一時的な classpath.jar のクラスパスだけでなく、この方法を使用して短縮された場合、コマンドライン全体をプレビューすることができます。 classpath.file : IntelliJ IDEA は、長いクラスパスをテキストファイルに書き込みます。 @argFiles (java 9+) : コマンドラインの長さの制限は @argument ファイルオプション(英語)を使用することで克服されます。この設定は、実行 / デバッグ構成を共有することを選択した場合には共有されるため、オペレーティングシステムに関係なく同じ方法がチームメンバーに適用されます。

テスト

項目	説明
繰り返し	テストを繰り返し実行する場合は、このリストからしきい値を選択します。テストを 1 回、`n` 回 (この場合は右側のフィールドに回数を指定します)、テストが成功するまで、テストが失敗するまで、停止するまで実行することを選択できます。
フォークモード	このオプションは、いくつかのテストをフォークする場合に作成される Java VM の数を制御します。メソッドまたはクラスを選択して、メソッドまたはクラスごとに個別の仮想マシンを作成します。このリストで使用可能なオプションは、テスト種類設定によって異なります。
テストの検索	IntelliJ IDEA が現在のパッケージに関連するテストクラスをプロジェクト内のどこで検索するかを選択します。このオプションは、パッケージ内すべて、タグ、パターン、カテゴリテストの種類で使用できます。プロジェクト全体 : IntelliJ IDEA は、すべてのプロジェクトモジュールでテストクラスを検索します。これはデフォルトのオプションです。シングルモジュール : IntelliJ IDEA は、モジュールのクラスパスを使用フィールドで選択されたモジュールでのみテストクラスを検索します。モジュール依存関係全体 : IntelliJ IDEA は、モジュールのクラスパスを使用フィールドで選択されたモジュールとそれに依存するモジュールでのみテストクラスを検索します。

項目

説明

繰り返し

テストを繰り返し実行する場合は、このリストからしきい値を選択します。テストを 1 回、n 回 (この場合は右側のフィールドに回数を指定します)、テストが成功するまで、テストが失敗するまで、停止するまで実行することを選択できます。

フォークモード

このオプションは、いくつかのテストをフォークする場合に作成される Java VM の数を制御します。メソッドまたはクラスを選択して、メソッドまたはクラスごとに個別の仮想マシンを作成します。

このリストで使用可能なオプションは、テスト種類設定によって異なります。

テストの検索

IntelliJ IDEA が現在のパッケージに関連するテストクラスをプロジェクト内のどこで検索するかを選択します。このオプションは、パッケージ内すべて、タグ、パターン、カテゴリテストの種類で使用できます。

プロジェクト全体 : IntelliJ IDEA は、すべてのプロジェクトモジュールでテストクラスを検索します。これはデフォルトのオプションです。
シングルモジュール : IntelliJ IDEA は、モジュールのクラスパスを使用フィールドで選択されたモジュールでのみテストクラスを検索します。
モジュール依存関係全体 : IntelliJ IDEA は、モジュールのクラスパスを使用フィールドで選択されたモジュールとそれに依存するモジュールでのみテストクラスを検索します。

ログ

次のオプションは、この構成の実行のログ記録に関連しています。詳細については、ログの表示を参照してください。

項目	説明
コンソールで表示するログファイルの指定	アプリケーションの実行中に表示するログファイルを指定します。をクリックして新しいログを追加します。ログファイルエイリアスの編集ダイアログで、次のように構成します。エイリアス : ログが表示されるタブの名前。ログファイルのロケーション : ログファイルまたは Ant パターン(英語)へのパスを指定します。ローリングログの複数のファイルがパターンに一致する場合、IntelliJ IDEA は最新のファイルを表示します。パターンでカバーできるすべてのファイルを表示する : パターンに一致するすべてのログを表示します。テーブル内のログについては、次のオプションを構成できます。アクティブ : 指定したログファイルを表示します。内容のスキップ : 以前の実行からの古いログメッセージを表示しません。
コンソール出力をファイルに保存する	コンソール出力を指定した場所に保存します。パスを手動で入力するか、参照ボタンをクリックして、開いたダイアログで目的の場所をポイントします。
メッセージが標準出力に出力されたときにコンソールを表示する	アプリケーションが標準出力ストリームに書き込む際にコンソールを有効化します。
メッセージが標準エラーに出力されたときにコンソールを表示する	アプリケーションが標準エラーストリームに書き込む際にコンソールを有効化します。

コードカバレッジ

次のオプションはコードカバレッジに関連しています。詳細については、コードカバレッジを参照してください。

項目	説明
クラスとパッケージを指定する	このテーブルでは、測定するクラスとパッケージを指定します。をクリックし、指定するクラスの追加またはパッケージの追加を選択します。リストでクラスとパッケージを選択し、ボタンをクリックして、リストからクラスとパッケージを削除することもできます。
クラスとパッケージを除外する	カバレッジから除外するクラスとパッケージを指定します。をクリックし、クラスの追加またはパッケージの追加を選択して、クラスとパッケージを指定します。

項目

説明

クラスとパッケージを指定する

このテーブルでは、測定するクラスとパッケージを指定します。をクリックし、指定するクラスの追加またはパッケージの追加を選択します。リストでクラスとパッケージを選択し、ボタンをクリックして、リストからクラスとパッケージを削除することもできます。

クラスとパッケージを除外する

カバレッジから除外するクラスとパッケージを指定します。

をクリックし、クラスの追加またはパッケージの追加を選択して、クラスとパッケージを指定します。

起動前

この領域では、選択した実行 / デバッグ構成を開始する前に実行するタスクを指定できます。タスクは、リストに表示されている順序で実行されます。

項目	説明
起動前タスクの追加	このオプションを有効にして、次の使用可能なタスクのいずれかを追加します。 Web ブラウザーの起動 : ブラウザーを起動するにはこのオプションを選択します。開いたダイアログで、ブラウザーの種類を選択し、開始 URL を入力します。また、ブラウザーを JavaScript デバッガーで起動するかどうかを指定します。外部ツールの実行 : 外部アプリケーションを実行します。開いたダイアログで、実行する 1 つまたは複数のアプリケーションを選択します。IntelliJ IDEA でまだ定義されていない場合は、定義を追加します。詳細については、「外部ツール」を参照してください。別の構成を実行 : 別の実行 / デバッグ構成を実行することを選択し、それが完了するまで待ってから現在の構成を開始します。複数の構成を並行して実行する場合は、複合実行 / デバッグ構成を使用してください。リモート外部ツールの実行 : リモート SSH 外部ツールを追加します。 Gradle タスクの実行 : Gradle タスクを実行します。開いたダイアログで、タスクを指定し、必要に応じて追加の構成を提供します。ビルド : 指定されたモジュールをコンパイルするために選択します。モジュールのビルドアクションが実行されます。コンパイル中にエラーが発生すると、IntelliJ IDEA は実行 / デバッグ構成を開始しようとしません。プロジェクトのビルド : プロジェクト全体をコンパイルすることを選択します。プロジェクトのビルドアクションが実行されます。コンパイル中にエラーが発生すると、IntelliJ IDEA は実行 / デバッグ構成を開始しようとしません。ビルド、エラーチェックなし : ビルドオプションと同じですが、IntelliJ IDEA はコンパイル結果に関係なく実行 / デバッグ構成を開始しようとします。アーティファクトのビルド : このオプションを選択して、アーティファクトを作成します。開いたダイアログで、構築する必要のある 1 つまたは複数のアーティファクトを選択します。 Maven ゴールの実行 : Maven ゴールを実行するには、このオプションを選択します。開いたダイアログで、実行するゴールを選択します。 Grunt タスクの実行 : Grunt タスクを実行するには、このオプションを選択してください。表示される Grunt タスクダイアログで、必要なタスクが定義されている Gruntfile.js を指定し、実行するタスクを選択して、Grunt ツールに渡す引数を指定します。 Node.js インタープリターの場所、渡すパラメーター、grunt-cli パッケージへのパスを指定します。 gulp タスクの実行 : Gulp タスクを実行するには、このオプションを選択してください。表示される Gulp タスクダイアログで、必要なタスクが定義されている Gulpfile.js を指定し、実行するタスクを選択して、Gulp ツールに渡す引数を指定します。 Node.js インタープリターの場所、それに渡すパラメーター、gulp パッケージへのパスを指定します。 npm スクリプトの実行 : npm スクリプトを実行するには、このオプションを選択してください。開いた NPM スクリプトダイアログで、npm 実行 / デバッグ構成設定を指定します。 TypeScript のコンパイル : 組み込み TypeScript コンパイラーを実行するように選択し、TypeScript コードに加えたすべての変更が生成された JavaScript ファイルに反映されるようにします。表示される TypeScript のコンパイル設定ダイアログで、エラーの確認チェックボックスを選択または選択解除して、エラーが検出された場合のコンパイラーの動作を設定します。エラーの確認チェックボックスが選択されていると、コンパイラーはすべてのエラーを表示し、実行構成は開始されません。エラーの確認チェックボックスがオフの場合、コンパイラーは検出されたすべてのエラーを表示しますが、実行構成は起動されます。データソースの切断 : 実行 / デバッグ構成を実行する前にデータソースへの接続を中断する場合は、このオプションを選択します。
開始時に実行 / デバッグツールウィンドウを開く	構成のタイプに応じて、この実行構成を開始するときに実行、デバッグ、サービスツールウィンドウを開きます。このオプションが無効になっている場合は、ツールウィンドウを手動で開くことができます。表示 \| ツールウィンドウ \| 実行または `Alt+4` 表示 \| ツールウィンドウ \| デバッグまたは `Alt+5` 表示 \| ツールウィンドウ \| サービスまたは `Alt+8`
開始時に実行 / デバッグツールウィンドウにフォーカス	テストの実行中は、実行構成ツールウィンドウにフォーカスを当てます。
開始前に実行 / デバッグ構成を表示する	実際に起動する前に、実行構成設定を表示してください。