JSTestDriver

• JetBrains マーケットプレイスからプラグインをインストールする説明に従って、設定 | プラグインページのマーケットプレースタブに JSTestDriver プラグインをインストールして有効にします。

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

1. 選択したフレームワークをダウンロードして WebStorm JavaScript ライブラリとして構成してください。

2. 以下のいずれか 1 つを実行します:

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

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

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

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

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

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

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

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

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

4. YAML(英語) を使用して構成ファイルを補完します。テストランナー構成ファイルの説明(英語)を参照してください。

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

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

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

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

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

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

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

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

2. JSTestDriver サーバーツールウィンドウ（表示 | ツールウィンドウ | JSTestDriver サーバー）を開き、ツールバーの をクリックします。

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

• ツールバーの をクリックします。

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

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

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

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

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

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

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

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

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

   

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

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

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

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

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

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

   

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

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

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

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

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

   

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

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

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

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