実行 / デバッグ構成: TestNG

TestNG 実行 / デバッグ構成は、TestNG フレームワークに準拠するテストを起動するために使用されます。ダイアログはいくつかのタブで構成されています。

共通オプション

名前

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

複数のインスタンスを許可する

この実行構成の複数のインスタンスを並行して実行できるようにします。

デフォルトでは無効になっており、別のインスタンスがまだ実行されているときにこの構成を開始すると、IntelliJ IDEA は実行中のインスタンスを停止して別のインスタンスを開始することを提案します。これは、実行構成が多くのリソースを消費し、複数のインスタンスを実行する正当な理由がない場合に役立ちます。

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

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

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

構成タブ

このタブの構成は、選択したテスト範囲 (パッケージ、プロジェクトなど) によって異なります。

項目	説明
テスト種類	パッケージ内すべて – パッケージ内のすべてのテストを実行します。パッケージフィールドで、パッケージの完全修飾名を指定します。パターン – 指定されたパターンに準拠するテストを実行します。パターンフィールドに、1 つ以上の TestNG テストクラスを入力します。グループ – テストグループを実行します。グループフィールドで、実行するグループを指定します。スイート – テストスイートを実行します。スイートフィールドに、対応する testng.xml ファイルを入力します。プロジェクト全体 – IDE はすべてのモジュールでテストを探しますシングルモジュール – IDE は、モジュールのクラスパスを使用フィールドで選択されたモジュールでのみテストを検索します。モジュール依存関係全体 – 前のオプションと同じですが、そのモジュールに依存するモジュールがあります。クラス – テストクラスを実行します。クラスフィールドに、実行するテストクラスの完全修飾名を入力します。メソッド – テストメソッドを実行します。
出力ディレクトリ	テストレポートが生成されるディレクトリ。

項目

説明

テスト種類

パッケージ内すべて – パッケージ内のすべてのテストを実行します。パッケージフィールドで、パッケージの完全修飾名を指定します。
パターン – 指定されたパターンに準拠するテストを実行します。パターンフィールドに、1 つ以上の TestNG テストクラスを入力します。
グループ – テストグループを実行します。グループフィールドで、実行するグループを指定します。
スイート – テストスイートを実行します。スイートフィールドに、対応する testng.xml ファイルを入力します。
- プロジェクト全体 – IDE はすべてのモジュールでテストを探します
- シングルモジュール – IDE は、モジュールのクラスパスを使用フィールドで選択されたモジュールでのみテストを検索します。
- モジュール依存関係全体 – 前のオプションと同じですが、そのモジュールに依存するモジュールがあります。
クラス – テストクラスを実行します。クラスフィールドに、実行するテストクラスの完全修飾名を入力します。
メソッド – テストメソッドを実行します。

出力ディレクトリ

テストレポートが生成されるディレクトリ。

JDK 設定

項目	説明
テストランナーのパラメーター	テストランナーに渡される引数。 VM オプションを指定する場合と同じルールを使用します。
作業ディレクトリ	アプリケーションの実行に使用する作業ディレクトリを指定します。このディレクトリは、すべての相対入力および出力パスの開始点です。デフォルトでは、作業ディレクトリはプロジェクトルートです。
環境変数	をクリックして環境変数ダイアログを開き、そこで変数を作成してその値を指定できます。
モジュールパスを使用	このチェックボックスは、JPMS モジュール (Java 9 以降) を持つプロジェクトで利用できます。これにより、テストをクラスまたはモジュールパス上で実行する方法を選択することができます。
JRE	使用する JRE。
コマンドラインを短縮	クラスパスが長くなりすぎる場合、または 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 ファイルオプション(英語)を使用することで克服されます。この設定は、実行 / デバッグ構成を共有することを選択した場合には共有されるため、オペレーティングシステムに関係なく同じ方法がチームメンバーに適用されます。

パラメーター

項目	説明
パラメーター
プロパティファイル	TestNG に渡す .properties ファイルを指定します。
名前 - 値	キーと値のペアとしての追加パラメーター。
リスナー
	これらのアイコンを使用して、リスナーのリストを作成します。

コードカバレッジタブ

このタブを使用して、コードカバレッジ監視オプションを構成します。

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

ログ

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

項目	説明
コンソールで表示するログファイルの指定	アプリケーションの実行中に表示するログファイルを指定します。をクリックして新しいログを追加します。ログファイルエイリアスの編集ダイアログで、次のように構成します。エイリアス : ログが表示されるタブの名前。ログファイルのロケーション : ログファイルまたは 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`
開始時に実行 / デバッグツールウィンドウにフォーカス	テストの実行中は、実行構成ツールウィンドウにフォーカスを当てます。
開始前に実行 / デバッグ構成を表示する	実際に起動する前に、実行構成設定を表示してください。

最終更新日: 2024 年 4 月 04 日

関連ページ：

コードカバレッジ

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

ログの表示

アプリケーションを実行すると、実行またはデバッグツールウィンドウの個別のタブで、関連するローカルログファイルを表示できます。IntelliJ IDEA が表示するログを識別するには、それぞれの実行 / デバッグ構成で指定する必要があります。ログを追加する：アプリの起動に使用する実行 / デバッグ構成で、ログタブをクリックします。ログファイルエイリアスの編集テーブルには、ログファイルのリストが表示されます。追加をクリックします。ログエイリアス（ツールウィンドウのタブに表示される名前）とログファイ...

外部ツール

サードパーティのコマンドラインアプリケーションを外部ツールとして構成して、IntelliJ IDEA から実行します。例: ワークフローでは、特定のスクリプト、コードジェネレーター、アナライザー、プリプロセッサーまたはポストプロセッサー、データベースユーティリティなどの実行が必要になる場合があります。外部ツールとして構成することにより、IntelliJ IDEA は専用のアクションを提供します。これは、メインメニューや特定のコンテキストメニューから実行したり、ショートカットを割り当てたり、特定の...

複数のターゲットを実行 / デバッグする

IntelliJ IDEA は、複数のものを一度に実行 / デバッグするいくつかの方法を提供します。たとえば、複数の異なるプロセスまたはタスクを起動する必要があるクライアントサーバーアプリや複雑なテストです。いずれにせよ、最初のステップは、起動する必要があるタスクまたはプロセスごとに実行構成を作成することです。必要な構成がすべて整ったら、起動するためのいくつかのオプションがあります。複合実行構成を使用する複数の構成を並行して起動する、起動前タスクを使用する複数の構成を順番に起動する、複数の構成を...

リモート外部ツール設定

このページでは、リモート外部ツールで行うことができる設定について説明します。外部ツールの追加と使用の詳細については、「外部ツール」を参照してください。ツールバーボタンを使用して、使用可能な外部ツールのリストを管理します。保持したいがメニューで使用できないツールとグループのチェックボックスをオフにします。追加新しい外部ツールを追加します。除去選択したツールまたはグループを削除します。編集選択したツールを編集します。アップ選択したツールをリスト内で上に移動します。ダウン選択したツールをリスト内で下に...

IntelliJ IDEA を使用してアプリケーションをコンパイルおよびビルドする

IntelliJ IDEA のコンパイルおよびビルドプロセスは、ソースファイルをコンパイルし、外部ライブラリ、プロパティファイル、構成をまとめて、生きたアプリケーションを生成します。IntelliJ IDEA は、Java 仕様に従って動作するコンパイラーを使用します。単一のファイルをコンパイルし、モジュールまたはプロジェクトの増分ビルドを使用して、プロジェクトを最初から再ビルドできます。純粋な Java または Kotlin プロジェクトがある場合、IntelliJ IDEA はビルドプロセス...