実行 / デバッグ構成: Node.js
作成:
次の Node.js バージョンは、WebStorm 2023.3 以降でサポートされています:
Node.js 22 - アクティブな長期サポート(LTS)バージョン
Node.js 24 - 現在のバージョン
詳細は サポートされている Node.js バージョン をご覧ください。
このページでは、構成固有の項目と、すべての実行 / デバッグ構成に共通の オプションについて説明します。 この構成の利用方法については、 Node.js の実行とデバッグ を参照してください。
このダイアログで、コンピューター上の Node.js アプリケーションと一緒にデバッガーを起動するための構成を作成します。
始める前に
Node.js をダウンロードしてインストールします。
構成タブ
項目 | 説明 |
|---|---|
ノードランタイム | このフィールドでは、使用する Node.js ランタイムを指定します。 ローカル、 リモート Node.js ランタイム、または Linux 用 Windows サブシステム上の Node.js を指定できます。 リストからランタイムを選択するか、 |
Node パラメーター | このフィールドに、Node.js 実行可能ファイルに渡される Node.js 固有のコマンドラインオプションを入力します。 最も一般的なオプションは次のとおりです。
完全なリストについては、 Node.js コマンドラインオプション(英語)を参照してください。 |
作業ディレクトリ | このフィールドでは、アプリケーションの 作業ディレクトリ(英語)を指定します。 デフォルトでは、フィールドには プロジェクトのルートフォルダーが表示されます。 |
JavaScript ファイル | このフィールドには、それを開始するアプリケーションのメインファイルへのパスを指定します(たとえば、 Express(英語) アプリケーションの場合は bin/www )。 CoffeeScript をデバッグする場合は、ソースマップを含む生成された JavaScript ファイルへのパスを指定します。 ファイルは外部で生成することも、ファイルウォッチャーを使用したコンパイルを通じて生成することもできます。 詳細については、 CoffeeScript のデバッグを参照してください。 |
アプリケーションパラメーター | このフィールドに、起動時に process.argv(英語) 配列を介してアプリケーションに渡される Node.js 固有の引数を入力します。 |
環境変数 | このフィールドには、Node.js 実行可能ファイル用のカスタム 環境変数を指定します。 変数の定義は、 環境変数 フィールドにセミコロン(
![]() または、フィールドの右側にある 閲覧する
|
Docker コンテナーの設定 | この読み取り専用フィールドには、ポートとボリュームのバインディングが表示されます。 ![]() |
Docker Compose | この領域では、Docker Compose に渡すコマンドとオプションを指定します。 デフォルト設定を受け入れるか、「 コマンドプレビュー を確認してください。 |
ブラウザー / ライブ編集タブ
このタブで、ブラウザーの動作を設定し、アプリケーションのクライアント側コードのデバッグを有効にします。 この機能は JavaScript Debug 実行構成によって提供されています。技術的には、WebStorm はサーバー側とクライアント側のコードごとに別々の実行構成を作成しますが、すべての設定は専用の Node.js 実行構成で指定します。
項目 | 説明 |
|---|---|
ブラウザーを開く | この領域のフィールドに、プロジェクトの HTML ファイルを指定して、内蔵 Web サーバーで起動するプロジェクトルートに従ってこのファイルへの正しい URL を作成します。 例: project_root/inner_folder/index.html を選択した場合、結果の URL は http://localhost:63342/project_root/inner_folder/index.html になります。 起動後 チェックボックスを選択すると、ブラウザーはアプリケーションの起動後にこのページを自動的に開きます。 別の方法として、手動で選択のブラウザーでこの URL アドレスでページを開くことによって同じ結果を見ることができます。 |
起動後 | このチェックボックスを選択すると、ブラウザーが自動的に開きます。 リストから使用するブラウザーを選択します。
|
JavaScript デバッガーを使用して | 選択したブラウザーでクライアントサイドコードのデバッグを有効にするには、このチェックボックスをオンにします。 |
ステップ実行タブ
このタブで、 ステップ実行オプションを指定します。
一部のスクリプトは、通常はデバッグする必要がないため、 ステップイン によってスキップされます。 このリストは、 ステップ実行中 タブで微調整できます。このタブは、 デバッグセッションを起動する実行/デバッグ構成にあります。 エディターからデバッグセッションを開始する場合、対応する 実行/デバッグ構成テンプレートのデフォルト設定が使用されます。
デバッグセッションの起動に使用する実行/デバッグ構成を開き、 ステップ実行中 タブに切り替えます。
自動 スマートステップイン を抑制するには、 常にスマートステップインする チェックボックスをオフにします。
ソースマップの
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
V8 プロファイリングタブ
このタブで V8 CPU とメモリのプロファイリングを有効にします。
項目 | 説明 |
|---|---|
CPU プロファイリング情報を記録する | アプリケーションの起動時に CPU プロファイリングデータの記録を開始するには、このチェックボックスをオンにします。 下の領域のコントロールが有効になります。 以下を指定してください。
|
ヒープスナップショットの取得を許可する | メモリプロファイリングを実行する場合は、このチェックボックスを選択してください。 |
ログタブ
このタブでは、 実行 ツールウィンドウの コンソール タブに morgan(英語) などのログツールによって生成された情報の表示を有効にします。 詳細については、 Node.js アプリの実行時にログを管理するを参照してください。
共通設定
実行構成を編集する場合(ただし実行構成テンプレートは除く)、次のオプションを指定できます:
項目 | 説明 |
|---|---|
名前 | 実行構成の名前を指定して、編集または実行時に他の構成の間ですばやく識別できるようにします。 |
複数のインスタンスを許可する | この実行構成の複数のインスタンスを並列実行できるようにします。 デフォルトでは無効になっており、他のインスタンスが実行中にこの構成を開始すると、WebStorm はそのインスタンスの停止と新しいインスタンスの開始を提案します。 これは、実行構成が多くのリソースを消費し、複数のインスタンスを実行する正当な理由がない場合に役立ちます。 |
プロジェクトファイルとして保存 | 実行構成設定を含むファイルを保存して、他のチームメンバーと共有します。 デフォルトの保存先は .idea/runConfigurations です。 ただし、 .idea ディレクトリを共有したくない場合は、プロジェクト内の任意の他のディレクトリに構成を保存できます。 デフォルトでは無効になっており、WebStorm は実行構成設定を .idea/workspace.xml に保存します。 |
ツールバー
実行 / デバッグ構成のツリービューには、project で利用可能な構成を管理したり、デフォルト構成テンプレートを調整したりするのに役立つツールバーがあります。
項目 | ショートカット | 説明 |
|---|---|---|
Alt+Insert | 実行 / デバッグ構成を作成します。 | |
Alt+Delete | 選択した実行 / デバッグ構成を削除します。 デフォルト設定は削除できません。 | |
Ctrl+D | 選択した実行 / デバッグ構成のコピーを作成します。 デフォルト設定のコピーを作成してください。 | |
このボタンは、 一時的な構成を選択した場合にのみ表示されます。 このボタンをクリックして、一時的な構成を永続的なものとして保存します。 | ||
新しいフォルダーに移動 / 新しいフォルダーを作成します。 実行 / デバッグ構成は、 フォルダーに配置することでグループ化できます。 フォルダーを作成するには、カテゴリ内の設定を選択し、 次に、設定をフォルダー内、フォルダー間、フォルダー外に移動するには、ドラッグまたは グループ化を解除するには、フォルダーを選択して | ||
このボタンをクリックすると、設定がアルファベット順にソートされます。 |
起動前
この領域では、選択した実行 / デバッグ構成を開始する前に実行するタスクを指定できます。 タスクは、リストに表示されている順序で実行されます。
項目 | ショートカット | 説明 |
|---|---|---|
Alt+Insert | このアイコンをクリックして、以下の利用可能なタスクのいずれかを追加します:
| |
Alt+Delete | このアイコンをクリックして、選択したタスクをリストから削除します。 | |
Enter | 選択したタスクを編集するには、このアイコンをクリックします。 開いたダイアログで必要な変更を加えます。 | |
Alt+Up Alt+Down | これらのアイコンをクリックして、選択したタスクをリスト内で 1 行上または下に移動します。 タスクは、リストに表示されている順に実行されます。 | |
このページを表示する | 実行 / デバッグ構成を実際に開始する前に、実行 / デバッグ構成設定を表示するには、このチェックボックスを選択します。 | |
ツールウィンドウをアクティブにする | デフォルトではこのチェックボックスは選択されており、実行 / デバッグ構成を開始すると 実行または デバッグツールウィンドウが開きます。 それ以外の場合、チェックボックスがオフの場合、ツールウィンドウは非表示になります。 ただし、構成が実行されている場合は、 Alt+4 または Alt+5 を押すことにより、構成に対応するツールウィンドウを自分で開くことができます。 |

