実行 / デバッグ構成: Mocha
作成:
このページでは、構成固有の項目と、すべての実行 / デバッグ構成に共通の オプションについて説明します。 この構成の利用方法については、 Mocha を参照してください。
このダイアログで、 Mocha テストフレームワークを使用して JavaScript 単体テストを実行およびデバッグするための設定を作成します。
始める前に
コンピューターに Node.js(英語) があることを確認してください。
設定で Node.js プラグインが有効になっていることを確認します。 Ctrl+Alt+S を押して設定を開き、 を選択します。 検索フィールドに Node.js と入力します。 プラグインに関する詳細は、 プラグインの管理を参照してください。
Mocha 固有の構成設定
項目 | 説明 |
|---|---|
ノードランタイム | このフィールドでは、使用する Node.js ランタイムを指定します。 設定済みのランタイムのいずれかを選択するか、 |
Node オプション | このフィールドに、Node.js 実行可能ファイルに渡される Node.js 固有のコマンドラインオプションを入力します。 詳細については、 Node パラメーターを参照してください。 |
作業ディレクトリ | このフィールドでは、アプリケーションの作業ディレクトリを指定します。 デフォルトでは、 作業ディレクトリ フィールドにはプロジェクトのルートフォルダーが表示されます。 この事前定義された設定を変更するには、目的のフォルダーへのパスを指定してください。 |
環境変数 | このフィールドには、Node.js 実行可能ファイル用のカスタム 環境変数を指定します。 変数の定義は、 環境変数 フィールドにセミコロン(
![]() または、フィールドの右側にある 閲覧する
|
Mocha パッケージ | このフィールドには、Mocha インストールホーム /npm/node_modules/mocha を指定してください。 Node パッケージマネージャーを通じて Mocha を通常どおりインストールした場合、WebStorm は Mocha のインストール先を自動的に検出します。 あるいは、実行可能ファイルへのパスを手動で入力するか、 閲覧する |
ユーザーインターフェース | このリストから、 テストフォルダーのテストが記述されている インターフェースを選択してください。 WebStorm は、選択した インターフェースに準拠したテストのみ認識します。 テスト実行中に WebStorm が別の インターフェースのテストを実行すると、テストセッションはエラーでキャンセルされます。 つまり、指定された テストフォルダー内のすべてのテストは同じ インターフェースで記述し、この インターフェースをリストから選択する必要があります。 |
追加の Mocha オプション | このフィールドでは、追加の Mocha コマンドラインオプション(英語)を指定します。 例: 自動テストのようなランナーをオンにするために その結果、現在の実行構成のテストは、 再実行 ボタン |
テスト | この領域に、実行するテストを指定します。 利用可能なオプションは次のとおりです:
|
Docker コンテナーの設定 | この読み取り専用フィールドには、ポートとボリュームのバインディングが表示されます。 ![]() |
Docker Compose | この領域では、Docker Compose に渡すコマンドとオプションを指定します。 デフォルト設定を受け入れるか、「 コマンドプレビュー を確認してください。 |
共通設定
実行構成を編集する場合(ただし実行構成テンプレートは除く)、次のオプションを指定できます:
項目 | 説明 |
|---|---|
名前 | 実行構成の名前を指定して、編集または実行時に他の構成の間ですばやく識別できるようにします。 |
プロジェクトファイルとして保存 | 実行構成設定を含むファイルを保存して、他のチームメンバーと共有します。 デフォルトの保存先は .idea/runConfigurations です。 ただし、 .idea ディレクトリを共有したくない場合は、プロジェクト内の任意の他のディレクトリに構成を保存できます。 デフォルトでは無効になっており、WebStorm は実行構成設定を .idea/workspace.xml に保存します。 |
ステップ実行タブ
このタブで、 ステップ実行オプションを指定します。
一部のスクリプトは、通常はデバッグする必要がないため、 ステップイン によってスキップされます。 このリストは、 ステップ実行中 タブで微調整できます。このタブは、 デバッグセッションを起動する実行/デバッグ構成にあります。 エディターからデバッグセッションを開始する場合、対応する 実行/デバッグ構成テンプレートのデフォルト設定が使用されます。
デバッグセッションの起動に使用する実行/デバッグ構成を開き、 ステップ実行中 タブに切り替えます。
自動 スマートステップイン を抑制するには、 常にスマートステップインする チェックボックスをオフにします。
ソースマップの
ignoreListフィールドからスクリプトをスキップするには、 ソースマップで指定された既知のサードパーティスクリプトを無視する チェックボックスを選択します。古い Chrome 固有のフィールド名
x_google_ignoreListは非推奨ですが、ignoreListフィールドがない場合は引き続き認識されることがあります。 詳しくは ソースマップ仕様を参照してください。カスタムスクリプトへのステップインを抑制するには、 以下のパターンに一致する URL を持つスクリプトにステップインしない チェックボックスを選択し、下の該当スクリプトのデフォルトリストを展開します。
*、?、**、!を使用します。
パターン構文
パターンでは次の文字がサポートされています:
アスタリスク
*は、スラッシュ/以外の任意の数の文字と一致します。 この文字は、単一のパス部分内で使用します。疑問符
?は、スラッシュ/以外の単一の文字と正確に一致します。二重アスタリスク
**は、セグメント全体として、任意の数のパスセグメントと一致します。 その意味は位置によって異なります:先頭部分として使用すると、任意の先頭シンボルと一致します。
末尾部分として使用すると、任意の末尾シンボルと一致します。
途中にある場合は、一つ以上の部分と一致します。 たとえば、
a/**/bはa/x/bおよびa/x/y/bと一致しますが、a/bとは一致しません。
末尾の二重アスタリスク
**が最後のセグメントの末尾にある場合(それ自体が完全なセグメントではない場合、たとえばfoo**)、そのセグメントの後の任意のサフィックスと一致します。 たとえば、foo**はfoo、foobar、foo/barと一致します。感嘆符
!で始まるパターンは、指定されたパターンを否定し、リスト内でそれより前に追加されたパターンを変更します。 それ自体の新しいパターンは追加されません。
- 例 1
パターンリスト
["**/*.ts", "!**/*.test.ts"]では、最初の glob がすべての .ts ファイルと一致します。 二番目のパターンは、最初の glob を変更して、すべての .test.ts ファイルを一致対象から除外します。- 例 2
渡された URL は、スラッシュ
/によって部分に分割されます。 したがって、**/node_modules/**は次のように分割されます::二重アスタリスク
**は、node_modulesセグメントより前の任意のパスと一致します。node_modulesは URL 内のnode_modulesと照合されます。二重アスタリスク
**は、後続のすべてに一致します。
その結果、パターン
**/node_modules/**はnode_modulesを含む任意の URL と一致します。スクリプトの URL はパターン全体に対して照合されることに注意してください。 二番目の二重アスタリスク
**を削除すると、パターンはnode_modulesで終わる任意の URL と一致しますが、そのような URL はおそらく存在しません。- 例 3
特定のファイル名で終わる任意のパターンと照合するには、二番目の二重アスタリスク
**を省略します。**/app.jsはapp.jsで終わるすべての URL と一致します。次のパターンリストは、 node_modules 内の app.js という名前のものを除くすべてのスクリプトを無視します。
**/node_modules/** !**/app.js
ツールバー
実行 / デバッグ構成のツリービューには、project で利用可能な構成を管理したり、デフォルト構成テンプレートを調整したりするのに役立つツールバーがあります。
項目 | ショートカット | 説明 |
|---|---|---|
Alt+Insert | 実行 / デバッグ構成を作成します。 | |
Alt+Delete | 選択した実行 / デバッグ構成を削除します。 デフォルト設定は削除できません。 | |
Ctrl+D | 選択した実行 / デバッグ構成のコピーを作成します。 デフォルト設定のコピーを作成してください。 | |
このボタンは、 一時的な構成を選択した場合にのみ表示されます。 このボタンをクリックして、一時的な構成を永続的なものとして保存します。 | ||
新しいフォルダーに移動 / 新しいフォルダーを作成します。 実行 / デバッグ構成は、 フォルダーに配置することでグループ化できます。 フォルダーを作成するには、カテゴリ内の設定を選択し、 次に、設定をフォルダー内、フォルダー間、フォルダー外に移動するには、ドラッグまたは グループ化を解除するには、フォルダーを選択して | ||
このボタンをクリックすると、設定がアルファベット順にソートされます。 |
起動前
この領域では、選択した実行 / デバッグ構成を開始する前に実行するタスクを指定できます。 タスクは、リストに表示されている順序で実行されます。
項目 | ショートカット | 説明 |
|---|---|---|
Alt+Insert | このアイコンをクリックして、以下の利用可能なタスクのいずれかを追加します:
| |
Alt+Delete | このアイコンをクリックして、選択したタスクをリストから削除します。 | |
Enter | 選択したタスクを編集するには、このアイコンをクリックします。 開いたダイアログで必要な変更を加えます。 | |
Alt+Up Alt+Down | これらのアイコンをクリックして、選択したタスクをリスト内で 1 行上または下に移動します。 タスクは、リストに表示されている順に実行されます。 | |
このページを表示する | 実行 / デバッグ構成を実際に開始する前に、実行 / デバッグ構成設定を表示するには、このチェックボックスを選択します。 | |
ツールウィンドウをアクティブにする | デフォルトではこのチェックボックスは選択されており、実行 / デバッグ構成を開始すると 実行または デバッグツールウィンドウが開きます。 それ以外の場合、チェックボックスがオフの場合、ツールウィンドウは非表示になります。 ただし、構成が実行されている場合は、 Alt+4 または Alt+5 を押すことにより、構成に対応するツールウィンドウを自分で開くことができます。 |

