TestNG
この記事から、プロジェクト用に TestNG をセットアップし、テストを作成し、実行してコードが正しく動作しているかどうかを確認する方法を学習します。それは始めるための基本的なステップだけを含んでいます。
TestNG について詳しく知りたい場合は、公式ドキュメント(英語)を参照してください。IntelliJ IDEA のテスト機能の詳細については、このセクションの他のトピックを参照してください。
Maven または Gradle を使用して、このページの手順に従うことを選択できます。
プロジェクトに TestNG を追加する
プロジェクトのルートディレクトリで pom.xml を開きます。
pom.xml で、Alt+Insert を押して、依存を選択します。
開いたダイアログで、検索フィールドに「
testNG
」と入力します。org.testng:testng
依存関係を見つけて、検索結果からそのバージョンを選択し、追加をクリックします。依存関係が pom.xml に追加されたら、Ctrl+Shift+O を押すか、Maven ツールウィンドウで をクリックして変更をインポートします。
プロジェクトのルートディレクトリで build.gradle を開きます。
build.gradle で、Alt+Insert を押して、Maven アーティファクト依存関係を追加を選択します。
開いたダイアログで、検索フィールドに「
testNG
」と入力します。org.testng:testng
依存関係を見つけて、検索結果からそのバージョンを選択し、追加をクリックします。依存関係が build.gradle に追加されたら、Ctrl+Shift+O を押すか、Gradle ツールウィンドウで をクリックして変更をインポートします。
メインメニューで、
(Ctrl+Alt+Shift+S) に移動します。プロジェクト設定でライブラリを選択し、 をクリックします。
開いたダイアログで、必要なライブラリアーティファクトを指定します(例:
org.testng:testng:6.14.3
)。変更を適用し、ダイアログを閉じます。
テストの作成
新しい TestNG クラスを作成する
プロジェクトツールウィンドウ (Alt+1) で、新しいテストクラスを作成するテストソースルート 内のパッケージを右クリックします。
コンテキストメニューから
を選択します。新規クラスの作成ダイアログで、新しいクラスに名前を付けて、OK をクリックします。
エディターで、テストクラスのコードを記述します。必要に応じて TestNG アノテーションを使用します。例: クラス全体または個々のメソッドにアノテーションを付けることができます:
import org.testng.Assert; import org.testng.annotations.DataProvider; import org.testng.annotations.Test; @Test() public class SampleTest { @DataProvider public Object[][] data() { return new String[][] {new String[] {"data1"}, new String[] {"data2"}}; } @Test(dataProvider = "data") public void test(String d) { Assert.assertEquals("First Line\nSecond Line", "First Line\nSecond Line"); } }
テストの実行
TestNG テストを実行する
個別のテストを実行するには、ガターの をクリックして、実行を選択します。
テストクラスですべてのテストを実行するには、テストクラス宣言に対して をクリックし、実行を選択します。
実行ツールウィンドウでテスト結果を表示できます。
テストを実行してレポートを生成する
IntelliJ IDEA では、VM オプションを追加したり、別の JDK を使用したり、実行構成を使用してコードカバレッジを有効にしたりできます。同じテストクラスまたは異なる設定のテストスイートに対して複数の構成を作成し、結果を比較できます。
TestNG の場合、レポートを生成するリスナー(英語)を構成できます。テストを実行するたびにレポートを生成したくない場合は、別の実行構成を作成すると便利な場合があります。
メインメニューで、
に移動します。以前に作成された TestNG 構成がない場合は、 をクリックし、開いたリストから TestNG を選択します。
それ以外の場合は、リストから必要な既存の構成を選択します。
新しい構成の場合は、名前を付けます。
テスト種類リストから、実行するテストの範囲を選択します。次のフィールドはそれに応じて変更され、実行する特定のテストを選択できるようになります。
出力ディレクトリフィールドでは、IDE がレポートを配置するフォルダーを指定できます。
デフォルトでは、IDE はプロジェクトのルートディレクトリに新しい test-output フォルダーを作成しますが、別のフォルダーを使用することも、別のレポートに別のフォルダーを使用することもできます。
リスナータブに切り替え、 をクリックして、
EmailableReporter
オプションを追加します。これにより、HTML レポートが生成されます。変更を適用し、ダイアログを閉じます。
ツールバーで、新しく作成された実行構成が選択されていることを確認し、その横にある をクリックします。または、Shift+F10 を押します。
IDE は、実行構成で指定したフォルダーにテスト実行の結果を含む .html レポートを作成します。フォルダーを指定していない場合は、レポートを含む test-output フォルダーが作成されます。
このファイルをブラウザーですぐに表示するには、エディターでファイルを開きます。次に、HTML ファイルのプレビュー出力」を参照してください。
に移動し、ブラウザーを選択します。組み込みのプレビューを使用してファイルを表示することもできます。詳細については、「テストスイート
TestNG では、テストスイートは、アプリケーションの特定の機能または機能をテストするように設計されたテストの集まりです。関連するテストケースのグループを保持するコンテナーです。テストスイートは、複数のテストケースをグループ化するか、複数のテストスイートを組み合わせて作成できます。
TestNG では、テストコードまたはメインテストソースコード内でテストスイートを定義することはできません。そのため、テストケース、テストケースを含むクラスまたはパッケージ、およびテストパラメーターに関する情報を含む XML または YAML ファイルでテストスイートを定義できます。
XML でテストスイートを作成する
テストスイートは、.xml または .yaml ファイルで指定できます。YAML を使用する場合は、対応する依存関係をビルドファイルに追加してください。
プロジェクトツールウィンドウでプロジェクトルートフォルダーを右クリックし、testng.xml) を入力します。
を選択して、ファイル名 (例:テストに関する情報をファイルに入力します。詳細については、testng.xml(英語) を参照してください。
テストスイートに YAML を使用する
TestNG は YAML を使用したテストスイートの定義をサポートしています(英語)が、デフォルトでは YAML パーサーは含まれていません。YAML ファイルを使用する場合は、snakeyaml
依存関係を追加します。バージョンは、使用する TestNG のバージョンと一致する必要があります。
ビルドファイル(pom.xml または build.gradle)を開き、Alt+Insert を押して、依存関係の追加を選択します。
開いたツールウィンドウで、検索フィールドに
snakeyaml
と入力します。必要な依存関係を見つけ、検索結果でそのバージョンを選択し、その横にある追加をクリックします。
Ctrl+Shift+O を押すか、エディターの右上隅に表示される通知をクリックして、変更をロードします。
プロジェクトツールウィンドウでプロジェクトルートフォルダーを右クリックし、testing.yaml) を入力します。
を選択して、ファイル名 (例:
テストスイートを実行する
TestNG テストスイートを実行できるようにするには、このスイートの実行構成を作成します。
メインメニューで、
に移動します。左側のペインで をクリックし、開いたリストから TestNG を選択します。新しい構成に名前を付けます。
テスト種類リストから、スイートを選択します。
スイートフィールドが使用可能になります。
スイートフィールドで、 をクリックし、テストスイートが構成されている XML または YAML ファイルへのパスを指定します。
出力ディレクトリフィールドでは、IDE がテストレポートなどの出力ファイルを配置するフォルダーを指定できます。
デフォルトでは、IDE はプロジェクトのルートディレクトリに新しい test-output フォルダーを作成しますが、別のフォルダーを使用することも、別の出力に別のフォルダーを使用することもできます。
変更を適用し、ダイアログを閉じます。
ツールバーで、新しく作成された実行構成が選択されていることを確認し、その横にある をクリックします。または、Shift+F10 を押します。
関連ページ:
Maven
IntelliJ IDEA は、構築プロセスの自動化に役立つ Maven との完全な機能統合をサポートしています。新しい Maven プロジェクトの作成、既存のプロジェクトのオープンと同期、既存の IntelliJ IDEA プロジェクトへの Maven サポートの追加、マルチモジュールプロジェクトの構成と管理を簡単に行うことができます。Maven プロジェクトを作成して WSL 環境に保存したり、WSL ファイルシステムから開いたりすることもできます。詳細については、WSL のセクションを参照してくだ...
Gradle
IntelliJ IDEA は、Gradle との完全に機能的な統合をサポートし、構築プロセスの自動化を支援します。新しい Gradle プロジェクトを簡単に作成し、既存のプロジェクトを開いて同期し、リンクされた複数のプロジェクトを同時に操作して、管理できます。Gradle プロジェクトを作成して WSL 環境に保存したり、WSL ファイルシステムから開いたりすることもできます。詳細については、WSL のセクションを参照してください。新規 Gradle プロジェクトを作成する新規プロジェクトウィザー...
テストの準備
IntelliJ IDEA は、JUnit、Spock、TestNG など、複数の Java テストフレームワークですぐに使用できます。IDE では、必要なテストメソッドとともに、ソースコードから直接テストクラスを作成できます。ショートカットを使用して、テストクラスとソースコードを切り替えたり、複数のテストを実行したり、各テストの統計を表示したり、テスト結果をファイルにエクスポートしたりできます。IntelliJ IDEA はコードカバレッジも備えており、コードを分析して、コードのどの領域がテスト...
テストの作成
IntelliJ IDEA で新しいテストクラスを作成する最も簡単な方法は、ソースコードから呼び出すことができる専用のインテンションアクションを使用することです。この場合、IDE は新しいテストクラスを作成し、このクラス、パッケージ、関数のテストコードを生成します。新しいテストを追加するエディターの本番コードで、テストを作成するクラスにキャレットを配置し、を押して、テストの作成を選択します。テストの作成ダイアログで、使用するライブラリを選択します。必要なライブラリがまだない場合は、ダウンロード...
コンテンツルート
IntelliJ IDEA のコンテンツは、ソースコード、ビルドスクリプト、テスト、ドキュメントを含むファイルのグループです。これらのファイルは通常、階層構造になっています。最上位フォルダーはコンテンツルートと呼ばれます。モジュールには通常、1 つのコンテンツルートがあります。コンテンツルートを追加することができます。たとえば、コードがコンピューター上の別の場所に格納されている場合には、これは便利です。同時に、モジュールはコンテンツルートなしで存在することができます。この場合、他のモジュールの依...
Maven でのテスト
Maven プロジェクトでは、デフォルトの IntelliJ IDEA テストランナーを使用して、他のプロジェクトと同じ方法でテストを作成および実行できます。簡単な JUnit テストを実行する Maven プロジェクトを開きます。エディターでテストクラスを作成または開き、ガターでクリックして実行します。結果は実行ツールウィンドウに表示されます。定期テストの作成または実行の詳細については、「テスト」セクションを参照してください。テストの実行を Maven に委譲できます。JUnit または Te...