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