IntelliJ IDEA 2026.1 Help

JSTestDriver

IntelliJ IDEA は JSTestDriver テストフレームワーク(英語)との統合をサポートします。

始める前に

  1. 設定で JavaScript and TypeScript プラグインが有効になっていることを確認します。 Ctrl+Alt+S を押して設定を開き、 プラグイン を選択します。 インストール済み タブをクリックします。 検索フィールドに JavaScript と TypeScript と入力します。 プラグインに関する詳細は、 プラグインの管理を参照してください。

  2. JetBrains マーケットプレイスからプラグインをインストールする説明に従って、 設定 | プラグイン ページの Marketplace タブに JSTestDriver プラグインをインストールして有効にします。 このプラグインは IntelliJ IDEA Ultimate でのみ利用可能です。

    このプラグインを通じて、IntelliJ IDEA は JSTestDriver サーバーとアサーションフレームワークを提供します。 テストの作成中に、プラグインはユニットテストフレームワークを検出し、 <テストフレームワーク> のサポートを追加する インテンションアクションを提案します。

プロジェクトでテストフレームワークを構成する

  1. 選択したフレームワークをダウンロードして、 IntelliJ IDEA JavaScript ライブラリとして構成します。

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

    • ライブラリスコープにプロジェクトフォルダーを追加します

    • <テストフレームワーク> のサポートを追加するインテンションアクションを使用して、テスト作成中にオンザフライでフレームワークサポートを有効にします。

    • Jasmine を使用するには、構成ファイルに jasmine-jstd-adapter を追加します。

      jsTestDriver.conf を開き、次のコードを入力します。

      load: lib/jasmine/jasmine.js lib/jasmine-jstd-adapter/JasmineAdapter.js

テストランナー構成ファイルを手動で作成する

テストランナー構成ファイルは、ロード順序をロードするためのテストファイルと実動ファイルを定義します。 IntelliJ IDEA は拡張子 .jstd または .conf を持つファイルをテストランナー構成ファイルとして扱います。

構成ファイルを作成するには

  1. プロジェクト ツリーで、運用フォルダーとテストフォルダーの親フォルダーを選択し、コンテキストメニューから 新規 | ファイル を選択します。

  2. 開いた 新規ファイル ダイアログで、拡張子 .jstd または .conf が付いた構成ファイルの名前を入力します。

  3. エディターで新しいファイルを開き、現在のフォルダーへのフルパスと、それに関連してロードするファイルへのパスを指定します。 ファイル名パターンにはワイルドカードを使用します。

  4. YAML を使用して構成ファイルを完成させ、 テストランナー構成ファイルの記述を参照してください。

テストを実行

IntelliJ IDEA を使用すると、エディターから 1 つの JSTestDriver テストをすぐに実行することも、実行 / デバッグ構成を作成してテストの一部または全部を実行することもできます。

エディターから単一のテストを実行するには

  • 左側のガターの 実行ボタン または 再実行ボタン をクリックして、リストから <test_name> の実行 を選択します。

  • ガターの テストステータスアイコン 成功したテスト および テストに失敗しました により、エディターでテストが成功したか失敗したかを確認することもできます。

JSTestDriver 実行構成を作成するには

  1. 実行 / デバッグ構成ダイアログ (メインメニューの 実行 | 実行構成の編集) を開き、左側のペインで 追加ボタン をクリックし、リストから JSTestDriver を選択します。 「実行 / デバッグ構成: JSTestDriver 」ダイアログが開きます。

  2. 実行するテスト、構成ファイルへのパス、テスト実行前に実行するアクティビティを指定します。

WebStorm のデフォルト JSTestDriver テストサーバーを起動するには

  1. プロジェクトに少なくとも 1 つの設定ファイルがあることを確認してください。

  2. JSTestDriver サーバー ツールウィンドウ(表示 | ツールウィンドウ | JSTestDriver サーバー )を開き、ツールバーの 実行ボタン をクリックします。

ユニットテストでサーバーを停止するには

  • ツールバーの the Stop the local server button をクリックします。

ブラウザーをキャプチャーするには

  1. JSTestDriver サーバーを起動するがまだ実行されていない場合は、 JSTestDriver サーバー ツールウィンドウに切り替えます。

  2. JSTestDriverリモートコンソール を使用してローカルブラウザーを起動するには、次のいずれかの操作を行います。

    • 選択したブラウザーを示すアイコンをクリックします。

    • ブラウザーがすでに開かれている場合は、 URL を使用してブラウザーをキャプチャーする 読み取り専用フィールドの内容をコピーし、URL をアドレスバーに貼り付けます。

    いずれの場合も、選択したブラウザーを示すアイコンがアクティブになります。

  3. JSTestDriver サーバー ツールウィンドウに切り替え、今開いたブラウザーを示すアイコンをクリックします。 IntelliJ IDEA は、テストを実行する準備ができていることを知らせるメッセージを表示します。

実行構成を介してテストを実行するには

  1. 構成のリストから JSTestDriver 実行 / デバッグ構成を選択し、リストまたはツールバーの the Run icon をクリックします。

  2. 実行 ツールウィンドウの テストランナー タブで、テストの実行を監視し、テスト結果を分析します。 詳細については、 テスト結果を調べるを参照してください。

ナビゲーション

IntelliJ IDEA を使用すると、ファイルと関連テストファイルの間、または テストランナータブのテスト結果からテストに移動できます。

  • テストとそのサブジェクト間、またはその逆に移動するには、エディターでファイルを開き、コンテキストメニューから テスト(S) へ移動 または 移動先 | テスト対象 を選択するか、 Ctrl+Shift+T を押します。

  • テスト結果からテスト定義に移動するには、「テストランナー 」タブでテスト名を 2 回クリックするか、コンテキストメニューから「ソースに移動 」を選択するか、単に F4 を押します。 テストファイルがエディターで開き、テスト定義にキャレットが置かれます。

デバッグテスト

JSTestDriver テスト用のデバッグセッションは、実行 / デバッグ構成によってのみ開始されます。

デバッグテストを開始するには

  1. 上記の説明に従って JSTestDriver 実行 / デバッグ構成を作成します。

  2. 構成のリストから JSTestDriver 実行 / デバッグ構成を選択し、リストまたはツールバーの the Debug icon をクリックします。

  3. 開いた デバッグツールウィンドウ で、通常どおり続行します: プログラムをステップ実行しプログラムの実行を停止して再開し中断時に調べ 、コールスタックと変数を調べ、ウォッチを設定し、変数を評価し、 実際の HTML DOM を表示します。

コードカバレッジの監視

IntelliJ IDEA を使用すると、コードのどの程度が Karma テストでカバーされている(英語)かを監視することもできます。 IntelliJ IDEA は、専用の カバレッジ ツールウィンドウにこの統計を表示し、エディターおよび プロジェクト ツールウィンドウ(Alt+1 )でカバーされた行とカバーされていない行を視覚的にマークします。

カバレッジでテストを開始する

  1. 上記の説明に従って JSTestDriver 実行 / デバッグ構成を作成します。

  2. JSTestDriver サーバーを起動するブラウザーをキャプチャーして 、テストを実行します。

  3. 構成のリストから JSTestDriver 実行 / デバッグ構成を選択し、リストまたはツールバーの the Run with Coverage icon をクリックします。

  4. カバレッジツールウィンドウでコードカバレッジを監視します。

カバレッジ分析からファイルを除外するには

  1. 上記の説明に従って JSTestDriver 実行 / デバッグ構成を作成します。

  2. カバレッジ タブで、除外するファイルへのパスを指定します。

2026 年 3 月 30 日