実行 / デバッグ構成: Node.js
作成:
次の Node.js バージョンは、CLion 2023.3 以降でサポートされています:
Node.js 22 - アクティブな長期サポート(LTS)バージョン
Node.js 24 - 現在のバージョン
詳細については、 サポートされている Node.js バージョン を参照してください。
このダイアログで、コンピューター上の Node.js アプリケーションと一緒にデバッガーを開始するための構成を作成します。
始める前に
Node.js をダウンロードしてインストールします。
JetBrains マーケットプレイスからプラグインをインストールする説明に従って、 に Node.js プラグインをインストールします。
構成タブ
項目 | 説明 |
|---|---|
ノードランタイム | このフィールドでは、使用する Node.js ランタイムを指定します。 ローカル、 リモート Node.js ランタイム、または Linux 用 Windows サブシステム上の Node.js を指定できます。 リストからランタイムを選択するか、 |
ノードパラメーター | このフィールドに、Node.js 実行可能ファイルに渡す Node.js 固有のコマンドラインオプションを入力します。 最も一般的なオプションは次のとおりです。
完全なリストについては、 Node.js コマンドラインオプション(英語)を参照してください。 |
作業ディレクトリ | このフィールドでは、アプリケーションの 作業ディレクトリ(英語)を指定します。 デフォルトでは、フィールドには プロジェクトのルートフォルダーが表示されます。 |
JavaScript ファイル | このフィールドには、それを開始するアプリケーションのメインファイルへのパスを指定します(たとえば、 Express(英語) アプリケーションの場合は bin/www )。 CoffeeScript をデバッグする場合は、ソースマップを含む生成された JavaScript ファイルへのパスを指定します。 ファイルは外部で生成することも、ファイルウォッチャーを使用したコンパイルを通じて生成することもできます。 詳細については、 CoffeeScript のデバッグを参照してください。 |
環境変数 | このフィールドでは、Node.js 実行可能ファイル用のカスタム 環境変数を指定します。 変数の定義は、 環境変数 フィールドにセミコロン (
![]() または、フィールドの右側にある 閲覧
|
Docker コンテナーの設定 | この読み取り専用フィールドには、ポートとボリュームのバインディングが表示されます。 ![]() |
Docker Compose | この領域では、Docker Compose に渡すコマンドとオプションを指定します。 デフォルト設定を受け入れるか、「 コマンドプレビュー を確認してください。 |
ブラウザー / ライブ編集タブ
このタブで、ブラウザーの動作を設定し、アプリケーションのクライアント側コードのデバッグを有効にします。 This functionality is provided through a JavaScript デバッグ run configuration, so technically, CLion creates separate run configurations for the server-side and the client-side code, but you specify all your settings in one dedicated Node.js run configuration.
項目 | 説明 |
|---|---|
ブラウザーを開く | この領域のフィールドに、プロジェクトの HTML ファイルを指定して、内蔵 Web サーバーで起動するプロジェクトルートに従ってこのファイルへの正しい URL を作成します。 例: project_root/inner_folder/index.html を選択した場合、結果の URL は http://localhost:63342/project_root/inner_folder/index.html になります。 起動後 チェックボックスを選択すると、ブラウザーはアプリケーションの起動後にこのページを自動的に開きます。 別の方法として、手動で選択のブラウザーでこの URL アドレスでページを開くことによって同じ結果を見ることができます。 |
起動後 | このチェックボックスを選択すると、ブラウザーが自動的に開きます。 リストから使用するブラウザーを選択します。
|
JavaScript デバッガーで | 選択したブラウザーでクライアントサイドコードのデバッグを有効にするには、このチェックボックスをオンにします。 |
ステップ実行タブ
このタブで、 ステップ実行オプションを指定します。
一部のスクリプトは、通常はデバッグする必要がないため、 ステップイン によってスキップされます。 このリストは、 設定 ダイアログ(Ctrl+Alt+S )の ページで微調整できます。
デバッグセッションを開始する実行/デバッグ構成を開き、 ステップ タブに切り替えます。
自動 スマートステップイン を抑止するには、 常にスマートステップインを行う チェックボックスをオフにします。
ソースマップの
ignoreListフィールドからスクリプトをスキップするには、 ソースマップで指定された既知のサードパーティスクリプトを無視する チェックボックスを選択します。古い Chrome 固有のフィールド名
x_google_ignoreListは非推奨ですが、ignoreListフィールドがない場合は引き続き認識されることがあります。 詳しくは ソースマップ仕様を参照してください。カスタムスクリプトへのステップインを抑止するには、 以下のパターンに一致する URL のスクリプトにステップインしない チェックボックスを選択し、下にあるそのようなスクリプトのデフォルトリストを展開します。
*、?、**、!を使用します。
パターン構文
パターンでは次の文字がサポートされています:
アスタリスク
*は、スラッシュ/以外のゼロ個以上の文字に一致します。 この文字は単一のパス部分内で使用します。疑問符
?は、スラッシュ/以外のちょうど一文字に一致します。セグメント全体としての double アスタリスク
**は、ゼロ個以上のパスセグメントに一致します。 その意味は位置によって異なります:最初の部分として使用すると、先頭の任意のシンボルに一致します。
最後の部分として使用すると、末尾の任意のシンボルに一致します。
中央では、ひとつ以上の部分に一致します。 例:
a/**/bはa/x/bとa/x/y/bに一致しますが、a/bには一致しません。
最後のセグメントの末尾にある double アスタリスク
**(単独で完全なセグメントではないもの。例:foo**) は、そのセグメントの後にある任意のサフィックスに一致します。 例:foo**はfoo、foobar、foo/barに一致します。感嘆符
!で始まるパターンは、指定されたパターンを否定し、リスト内でその前に追加されたパターンを変更します。 それ自体で新しいパターンを追加するわけではありません。
- 例 1
パターンリスト
["**/*.ts", "!**/*.test.ts"]では、最初の glob はすべての .ts ファイルに一致します。 後者のパターンは、最初の glob を変更して、すべての .test.ts ファイルを一致対象から除外します。- 例 2
渡された URL は、スラッシュ
/によって部分に分割されます。 したがって、**/node_modules/**は次のように分割されます::double アスタリスク
**は、node_modulesセグメントの前にある任意のパスに一致します。node_modulesは URL 内のnode_modulesと一致します。double アスタリスク
**は、後続の任意の内容に一致します。
その結果、パターン
**/node_modules/**はnode_modulesを含む任意の URL に一致します。スクリプトの URL はパターン全体に対して照合されることに注意してください。 後者の double アスタリスク
**を削除すると、パターンはnode_modulesで終わる任意の URL に一致しますが、そのような URL はおそらくゼロです。- 例 3
特定のファイル名で終わる任意のパターンと照合するには、後者の double アスタリスク
**を省略します。**/app.jsはapp.jsで終わるすべての URL に一致します。次のパターンリストでは、 node_modules 内のすべてのスクリプトが無視されます。ただし、 app.js と命名されたものは除きます。
**/node_modules/** !**/app.js
V8 プロファイリングタブ
このタブで、 V8 CPU とメモリのプロファイリングを有効化します。
項目 | 説明 |
|---|---|
CPU プロファイリング情報を記録する | アプリケーションの起動時に CPU プロファイリングデータの記録を開始するには、このチェックボックスをオンにします。 下の領域のコントロールが有効になります。 以下を指定してください。
|
ヒープスナップショットの取得を許可する | メモリプロファイリングを実行する場合は、このチェックボックスを選択してください。 |
共通設定
実行構成を編集する場合(ただし実行構成テンプレートは除く)、次のオプションを指定できます:
項目 | 説明 |
|---|---|
命名方法名 | 実行構成の名前を指定して、編集または実行時に他の構成の間ですばやく識別できるようにします。 |
複数のインスタンスを許可する | この実行構成の複数のインスタンスを並行して実行できるようにします。 デフォルトでは無効になっており、別のインスタンスがまだ実行中にこの構成を開始すると、CLion は実行中のインスタンスを停止して別のものを開始するよう提案します。 これは、実行構成が多くのリソースを消費し、複数のインスタンスを実行する正当な理由がない場合に役立ちます。 |
プロジェクトファイルとして保存する。 | 実行構成設定を含むファイルを保存して、他のチームメンバーと共有します。 デフォルトの場所は .idea/runConfigurations です。 ただし、 .idea ディレクトリを共有したくない場合は、構成をプロジェクト内の任意の他のディレクトリに保存できます。 デフォルトでは無効になっており、CLion は実行構成設定を .idea/workspace.xml に保存します。 |
ツールバー
実行 / デバッグ構成のツリービューには、プロジェクト で利用できる構成の管理や、デフォルト構成テンプレートの調整に役立つツールバーがあります。
項目 | ショートカット | 説明 |
|---|---|---|
Alt+Insert | 実行 / デバッグ構成を作成します。 | |
Alt+Delete | 選択した実行 / デバッグ構成を削除します。 デフォルト設定は削除できません。 | |
Ctrl+D | 選択した実行 / デバッグ構成のコピーを作成します。 デフォルト設定のコピーを作成してください。 | |
このボタンは、 一時的な構成を選択した場合にのみ表示されます。 このボタンをクリックして、一時的な構成を永続的なものとして保存します。 | ||
新しいフォルダーに移動 / 新しいフォルダーを作成します。 実行 / デバッグ構成は、 フォルダーに配置することでグループ化できます。 フォルダーを作成するには、カテゴリ内の設定を選択し、 次に、設定をフォルダー内、フォルダー間、フォルダー外に移動するには、ドラッグまたは グループ化を解除するには、フォルダーを選択して | ||
このボタンをクリックすると、設定がアルファベット順にソートされます。 |
起動前
この領域では、選択した実行 / デバッグ構成を開始する前に実行するタスクを指定できます。 タスクは、リストに表示されている順序で実行されます。
項目 | ショートカット | 説明 |
|---|---|---|
Alt+Insert | このアイコンをクリックして、以下の利用可能なタスクのいずれかを追加します:
| |
Alt+Delete | このアイコンをクリックして、選択したタスクをリストから削除します。 | |
Enter | 選択したタスクを編集するには、このアイコンをクリックします。 開いたダイアログで必要な変更を加えます。 | |
Alt+Up Alt+Down | これらのアイコンをクリックして、選択したタスクをリスト内で 1 行上または下に移動します。 タスクは、リストに表示されている順に実行されます。 | |
このページを表示する | 実行 / デバッグ構成を実際に開始する前に、実行 / デバッグ構成設定を表示するには、このチェックボックスを選択します。 | |
ツールウィンドウをアクティブにする | デフォルトではこのチェックボックスは選択されており、実行 / デバッグ構成を開始すると 実行または デバッグツールウィンドウが開きます。 それ以外の場合、チェックボックスがオフの場合、ツールウィンドウは非表示になります。 ただし、設定の実行中は、 Alt+4 または Alt+5 を押すことで、対応するツールウィンドウを自分で開くことができます。 |

