# JS テストドライバー

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com/ja-jp/help/clion/llms.txt).

> **TL;DR**
> 必須プラグイン：
>
>
>
> JavaScript and TypeScript   - このプラグインは CLion にバンドルされており、デフォルトで有効化されています。
>
>
>
> JS テストドライバー   -    設定 | プラグイン   ページでプラグインをインストールします。

CLion supports integration with the [JSTestDriver test framework](https://code.google.com/archive/p/js-test-driver/wikis/GettingStarted.wiki).

## 始める前に

Procedure:

1. 設定で  JavaScript and TypeScript  プラグインが有効になっていることを確認します。 `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `⌘ Comma` (Xcode), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (ReSharper), `⌘ Comma` (ReSharper (macOS)), `Ctrl+Alt+S` (QtCreator), `⌘ Comma` (QtCreator (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) を押して設定を開き、  `プラグイン`  を選択します。 検索フィールドに  JavaScript と TypeScript  と入力します。 プラグインの詳細については、 [プラグインの管理](managing-plugins.html)を参照してください。

2. [JetBrains Marketplace からプラグインをインストールする](managing-plugins.html#install_plugin_from_repo)の説明に従って、   設定 | プラグイン   ページで  JSTestDriver  プラグインをインストールして有効化します。￥n回覆 contains weird? Wait final must JSON only no code. I accidentally set with response format? The final content has invalid? I see after text a weird

Through this plugin, CLion provides the JSTestDriver server and the assertion framework. テストの作成中に、プラグインはユニットテストフレームワークを検出し、  <テストフレームワーク> のサポートを追加する  [インテンションアクション](intention-actions.html)を提案します。

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

Procedure:

1. 選択したフレームワークをダウンロードし、 [CLion JavaScript ライブラリとして構成します](configuring-javascript-libraries.html#ws_js_custom_third_party_library)。

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

* [ライブラリスコープにプロジェクトフォルダーを追加します](configuring-javascript-libraries.html#ws_js_configuring_js_libs_change_scope)。

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

* Jasmine を使用するには、構成ファイルに `jasmine-jstd-adapter` を追加します。 `jsTestDriver.conf` を開き、次のコードを入力します。 ``` load: lib/jasmine/jasmine.js lib/jasmine-jstd-adapter/JasmineAdapter.js ```

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

テストランナー構成ファイルは、ロード順序をロードするためのテストファイルと実動ファイルを定義します。 CLion treats any file with the extension  `.jstd`  or  `.conf`  as a test runner configuration file.

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

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

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

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

4. [YAML](http://www.yaml.org/) を使用して構成ファイルを完成させ、 [テストランナー構成ファイルの説明](http://code.google.com/p/js-test-driver/wiki/ConfigurationFile)を参照してください。

## テストの実行

CLion では、エディターから単一の JSTestDriver テストをすばやく実行するか、実行/デバッグ構成を作成してテストの一部またはすべてを実行できます。

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

* 左側のガターの ![the Run button](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.run.run.svg) または ![再実行ボタン](https://resources.jetbrains.com/help/img/idea/2026.3/app.actions.rerun.svg) をクリックして、リストから   実行 <テスト名>；   を選択します。

* ガターの  テストステータス アイコン ![テストが成功しました](https://resources.jetbrains.com/help/img/idea/2026.3/app.runConfigurations.testState.green2.svg) および ![テストが失敗しました](https://resources.jetbrains.com/help/img/idea/2026.3/app.runConfigurations.testState.red2.svg) により、エディターでテストが成功したか失敗したかを確認することもできます。

> **Tip:**
> 矢印は、テストで使用されているテストフレームワークがプロジェクトに関連付けられている場合にのみ表示され、CLion がテストを認識できるようになります。

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

1. [実行 / デバッグ構成](run-debug-configurations-dialog.html)ダイアログ (メインメニューの  `実行 | 実行構成の編集​`  ) を開き、左側のペインで ![追加ボタン](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg) をクリックし、リストから   JS テストドライバー   を選択します。 「   実行 / デバッグ構成: JSTestDriver  」ダイアログが開きます。

> **Tip:**
> または、   プロジェクト   ツールウィンドウ（ `Alt+1` (Windows), `⌘ 1` (macOS), `⌘ 1` (IntelliJ IDEA Classic (macOS)), `⌘ 1` (macOS System Shortcuts), `Alt+1` (XWin), `Alt+1` (GNOME), `Alt+1` (KDE), `Alt+1` (Emacs), `Alt+1` (Sublime Text), `⌘ 1` (Sublime Text (macOS)), `⌘ 1` (Xcode), `Ctrl+Alt+L` (Visual Studio), `⌘ ⌥ L` (Visual Studio (macOS)), `Alt+1` (ReSharper), `⌘ 1` (ReSharper (macOS)), `Alt+X` (QtCreator), `⌃ X` (QtCreator (macOS)), `Ctrl+1` (NetBeans), `Alt+1` (Eclipse), `Alt+1` (Eclipse (macOS)) ）でテストファイルを選択し、コンテキストメニューから   <ファイル名> を作成；   を選択します。

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

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

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

2. JSTestDriver サーバー   ツールウィンドウ（  `表示 | ツールウィンドウ | JSTestDriver サーバー`  ）を開き、ツールバーの ![the Run button](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.run.run.svg) をクリックします。

> **Tip:**
> 別のマシンで実行されているか、カスタムポートをリスニングしているテストサーバーを使用するには、サーバー固有の指示に従って起動し、   実行 / デバッグ構成: JSTestDriver   ダイアログの   サーバー   領域にその URL アドレスを指定します。

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

* ツールバーの ![「ローカルサーバーを停止」ボタン](https://resources.jetbrains.com/help/img/idea/2026.3/app.actions.suspend.svg) をクリックします。

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

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

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

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

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

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

3. JSTestDriver サーバー   ツールウィンドウに切り替え、今開いたブラウザーを示すアイコンをクリックします。 CLion displays a message informing you that it is ready for executing tests.

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

1. 構成の一覧から JSTestDriver の実行 / デバッグ構成を選択し、一覧またはツールバーの ![実行アイコン](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.run.run.svg) をクリックします。

2. 実行   ツールウィンドウの   テストランナー   タブで、テストの実行を監視し、テスト結果を分析します。 詳細については、 [テスト結果の検証](viewing-and-exploring-test-results.html) を参照してください。

## ナビゲーション

CLion を使えば、ファイルと関連するテストファイルの間や、 [テストランナータブ](null)のテスト結果からテストにジャンプできます。

Procedure:

* テストとそのサブジェクト間、またはその逆に移動するには、エディターでファイルを開き、コンテキストメニューから  `Go to | テスト`  または  `Go to | テスト対象`  を選択するか、 `Ctrl+Shift+T` (Windows), `⌘ ⇧ T` (macOS), `⌘ ⇧ T` (IntelliJ IDEA Classic (macOS)), `⌃ ⇧ T` (macOS System Shortcuts), `Ctrl+Shift+T` (XWin), `Ctrl+Shift+T` (GNOME), `Ctrl+Shift+T` (KDE), `Ctrl+Shift+T` (Emacs), `Ctrl+Shift+T` (Sublime Text), `Ctrl+Shift+T` (Sublime Text (macOS)), `⌘ ⇧ T` (Xcode), `Ctrl+Shift+T` (Visual Studio), `Ctrl+Shift+T` (Visual Studio (macOS)), `Ctrl+Shift+T` (ReSharper), `Ctrl+Shift+T` (ReSharper (macOS)), `Ctrl+Shift+T` (QtCreator), `Ctrl+Shift+T` (QtCreator (macOS)), `Ctrl+Shift+T` (NetBeans), `Ctrl+Shift+T` (Eclipse), `Ctrl+Shift+T` (Eclipse (macOS)) を押します。

* テスト結果からテスト定義に移動するには、「   テストランナー   」タブでテスト名を 2 回クリックするか、コンテキストメニューから「  `ソースに移動`  」を選択するか、単に `F4` (Windows), `⌘ ↓` (macOS), `F4` (IntelliJ IDEA Classic (macOS)), `F4` (macOS System Shortcuts), `F4` (XWin), `F4` (GNOME), `F4` (KDE), `F4` (Emacs), `F4` (Sublime Text), `F4` (Sublime Text (macOS)), `⌘ ↓` (Xcode), `F4` (Visual Studio), `⌘ ↓` (Visual Studio (macOS)), `F4` (ReSharper), `⌘ ↓` (ReSharper (macOS)), `F4` (QtCreator), `F4` (QtCreator (macOS)), `F4` (NetBeans), `F12` (Eclipse), `F3` (Eclipse (macOS)) を押します。 テストファイルがエディターで開き、テスト定義にキャレットが置かれます。

## デバッグテスト

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

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

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

2. 構成の一覧から JSTestDriver の実行 / デバッグ構成を選択し、一覧またはツールバーの ![デバッグアイコン](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.run.debug.svg) をクリックします。

3. 開いた [デバッグツールウィンドウ](debug-tool-window.html)で、通常通りに操作します。 [プログラムをステップ実行](stepping-through-the-program.html)し、 [実行を停止や再開](null)し、中断時は [プログラムを確認](examining-suspended-program.html)、コールスタックと変数を調査し、ウォッチを設定し、変数を評価し、 [実際の HTML DOM を表示](viewing-actual-html-dom.html)などが行えます。

ソースマップを無視して実際に実行されるコードをステップ実行するには、 ![ソースマップ無効化トグルボタン](https://resources.jetbrains.com/help/img/idea/2026.3/sourceMapDisable.png) を   デバッグ   ツールウィンドウのツールバーで押します。

## コードカバレッジの監視

With CLion, you can also monitor how much of your code is [covered with Karma tests](http://en.wikipedia.org/wiki/Code_coverage). CLion は、専用の   カバレッジ  ツールウィンドウにこの統計情報を表示し、カバーされた行とカバーされていない行をエディターおよび   プロジェクト  ツールウィンドウ（ `Alt+1` (Windows), `⌘ 1` (macOS), `⌘ 1` (IntelliJ IDEA Classic (macOS)), `⌘ 1` (macOS System Shortcuts), `Alt+1` (XWin), `Alt+1` (GNOME), `Alt+1` (KDE), `Alt+1` (Emacs), `Alt+1` (Sublime Text), `⌘ 1` (Sublime Text (macOS)), `⌘ 1` (Xcode), `Ctrl+Alt+L` (Visual Studio), `⌘ ⌥ L` (Visual Studio (macOS)), `Alt+1` (ReSharper), `⌘ 1` (ReSharper (macOS)), `Alt+X` (QtCreator), `⌃ X` (QtCreator (macOS)), `Ctrl+1` (NetBeans), `Alt+1` (Eclipse), `Alt+1` (Eclipse (macOS))）で視覚的にマークします。

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

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

2. [JSTestDriver サーバーを起動する](#start_server)と [ブラウザーをキャプチャーして](#capture_browser)、テストを実行します。

3. 構成の一覧から JSTestDriver の実行 / デバッグ構成を選択し、一覧またはツールバーの ![カバレッジ付き実行アイコン](https://resources.jetbrains.com/help/img/idea/2026.3/app.general.runWithCoverage.svg) をクリックします。

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

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

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

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

## See also

### プロシージャ

