実行 / デバッグ構成: Node.js

Node runtime

このフィールドに、使用する Node.js ランタイムを指定します。 これは、 ローカルまたは リモートの Node.js ランタイム、または Linux用のWindows Subsystem (WSL) 上の Node.js です。 リストからランタイムを選択するか、 をクリックして表示されるダイアログで新しいランタイムを設定します。

Node パラメーター

このフィールドに、Node.js 実行可能ファイルに渡される Node.js 固有のコマンドラインオプションを入力します。 最も一般的なオプションは次のとおりです。

• 実行中に CoffeeScript ファイルをオンザフライで JavaScript にコンパイルするには、 --require coffeescript/register を使用します。

  このモードでは、 coffeescript パッケージの一部である register.js ファイルがプロジェクト内に配置されている必要があります。 CoffeeScript コンパイラーをインストールするの説明に従って、 coffeescript パッケージがローカルにインストールされていることを確認してください。

• Chrome デバッグプロトコル(英語)サポートには --inspect または --inspect-brk パラメーターを使用します。

完全なリストについては、 Node.js コマンドラインオプション(英語)を参照してください。

作業ディレクトリ

このフィールドでは、アプリケーションの 作業ディレクトリ(英語)を指定します。 デフォルトでは、フィールドには プロジェクトのルートフォルダーが表示されます。

JavaScript ファイル

このフィールドには、それを開始するアプリケーションのメインファイルへのパスを指定します（たとえば、 Express(英語) アプリケーションの場合は bin/www ）。

CoffeeScript をデバッグする場合は、ソースマップを含む生成された JavaScript ファイルへのパスを指定します。 ファイルは外部で生成することも、ファイルウォッチャーを使用したコンパイルを通じて生成することもできます。 詳細については、 CoffeeScript のデバッグを参照してください。

アプリケーションパラメーター

このフィールドに、起動時に process.argv(英語) 配列を介してアプリケーションに渡される Node.js 固有の引数を入力します。

環境変数

このフィールドでは、必要に応じて、Node.js 実行可能ファイルの 環境変数を指定します。 フィールドの右側にある 参照 をクリックし、表示される 環境変数 ダイアログで変数のリストを設定します。

• 新しい変数を定義するには、 をクリックして、変数の名前と値を指定します。

• 変数定義を破棄するには、リストでそれを選択して をクリックします。

• 準備ができたら、 OK をクリック

変数の定義は、 環境変数 読み取り専用フィールドにセミコロンを区切りとして表示されます。例えば：

• NODE_PATH: モジュール検索パスの前に付いたディレクトリの :-separated リスト。

• NODE_MODULE_CONTEXTS: 独自のグローバルコンテキストでモジュールをロードするには 1 に設定します。

• NODE_DISABLE_COLORS: REPL の色を無効にするには 1 に設定します。

Docker コンテナーの設定

この読み取り専用フィールドには、ポートとボリュームのバインディングが表示されます。 をクリックして、コマンドプレビューを開きます。

Docker Compose

この領域では、Docker Compose に渡すコマンドとオプションを指定します。 デフォルト設定を受け入れるか、「 」をクリックしてカスタム設定 (たとえば、 --rm や --service-ports などのカスタム Docker Compose フラグ) を指定します。 詳細については、 Docker オフィシャル Web サイト(英語)を参照してください。

コマンドプレビュー を確認してください。

ブラウザーを開く

この領域のフィールドに、プロジェクトの HTML ファイルを指定して、内蔵 Web サーバーで起動するプロジェクトルートに従ってこのファイルへの正しい URL を作成します。 例: project_root/inner_folder/index.html を選択した場合、結果の URL は http://localhost:63342/project_root/inner_folder/index.html になります。 起動後 チェックボックスを選択すると、ブラウザーはアプリケーションの起動後にこのページを自動的に開きます。 別の方法として、手動で選択のブラウザーでこの URL アドレスでページを開くことによって同じ結果を見ることができます。

起動後

このチェックボックスを選択すると、ブラウザーが自動的に開きます。 リストから使用するブラウザーを選択します。

• システムデフォルトブラウザーを使用するには、 デフォルト を選択します。

• カスタムブラウザーを使用するには、リストからブラウザーを選択します。 JavaScript クライアント側コードのデバッグは、 Google Chrome(英語) およびその他の Chromium ベースのブラウザー(英語)でのみサポートされていることに注意してください。

• ブラウザーを構成するには、 をクリックし、表示される ウェブブラウザーとプレビュー ダイアログで設定を調整します。 詳細は、 ウェブブラウザー を参照してください。

JavaScript デバッガーを使用

選択したブラウザーでクライアントサイドコードのデバッグを有効にするには、このチェックボックスをオンにします。

CPU プロファイリング情報を記録する

アプリケーションの起動時に CPU プロファイリングデータの記録を開始するには、このチェックボックスをオンにします。 下の領域のコントロールが有効になります。 以下を指定します。

• ログフォルダー:: このフィールドでは、記録されたログを保存するフォルダーを指定します。 プロファイリングデータはログファイル isolate-<session number> に保存されます。

• すべての Isolate (V8 インスタンス) に対して 1 つのログファイルを作成する: すべての V8 インスタンスに対して 1 つのログファイル (およびそれに応じて 1 つのプロファイリング結果ビュー) のみを作成するには、このチェックボックスをオンにします。 インスタンスごとに個別のファイルを作成するには、チェックボックスをオフにします。 Node.js は、デバッグプロセスなどのために追加の V8 インスタンスを作成できます。

ヒープスナップショットの取得を許可する

メモリプロファイリングを実行する場合は、このチェックボックスを選択してください。

名前(N)

実行構成の名前を指定して、編集または実行時に他の構成の間ですばやく識別できるようにします。

複数のインスタンスを許可する(U)

この実行構成の複数のインスタンスを並行して実行できるようにします。

デフォルトでは無効になっており、別のインスタンスがまだ実行されているときにこの構成を開始すると、IntelliJ IDEA は実行中のインスタンスを停止して別のインスタンスを開始することを提案します。 これは、実行構成が多くのリソースを消費し、複数のインスタンスを実行する正当な理由がない場合に役立ちます。

プロジェクトファイルとして保存(S)

実行構成設定を含むファイルを保存して、他のチームメンバーと共有します。 デフォルトの場所は .idea/runConfigurations です。 ただし、 .idea ディレクトリを共有したくない場合は、プロジェクト内の他のディレクトリに構成を保存できます。

デフォルトでは無効になっており、IntelliJ IDEA は実行構成設定を .idea/workspace.xml に保存します。

Alt+Insert

実行 / デバッグ構成を作成します。

Alt+Delete

選択した実行 / デバッグ構成を削除します。 デフォルト設定は削除できません。

Ctrl+D

選択した実行 / デバッグ構成のコピーを作成します。 デフォルト設定のコピーを作成してください。

このボタンは、 一時構成を選択した場合にのみ表示されます。 このボタンをクリックして、一時的な構成を永続的なものとして保存します。

新しいフォルダーに移動 / 新しいフォルダーを作成します。 実行 / デバッグ構成は、 フォルダーに配置することでグループ化できます。

フォルダーを作成するには、カテゴリ内の設定を選択し、 をクリックしてフォルダー名を指定します。 カテゴリだけにフォーカスがある場合は、空のフォルダーが作成されます。

次に、設定をフォルダー内、フォルダー間、フォルダー外に移動するには、ドラッグまたは ボタンと ボタンを使用します。

グループ化を解除するには、フォルダーを選択して をクリックします。

このボタンをクリックすると、設定がアルファベット順にソートされます。

Alt+Insert

このアイコンをクリックして、以下の使用可能なタスクのいずれかを追加します。

• Web ブラウザーの起動: ブラウザーを起動するには、このオプションを選択します。 開いたダイアログで、ブラウザーの種類を選択し、開始 URL を指定します。 また、ブラウザーを JavaScript デバッガーで起動するかどうかを指定します。

• 外部ツールの実行: 外部アプリケーションを実行することを選択します。 開いたダイアログで、実行する 1 つまたは複数のアプリケーションを選択します。 IntelliJ IDEA でまだ定義されていない場合は、定義を追加します。 詳細については、 外部ツール と 外部ツール設定 を参照してください。

• 別の構成を実行: 別の実行 / デバッグ構成を実行することを選択し、それが完了するまで待ってから現在の構成を開始します。 複数の構成を並行して実行する場合は、 複合実行 / デバッグ構成を使用してください。

• ビルド: 指定されたモジュールをコンパイルするために選択します。 ビルドモジュールコマンドが実行されます。

  コンパイル中にエラーが発生すると、IntelliJ IDEA は実行 / デバッグ構成を開始しようとしません。

• プロジェクトのビルド: プロジェクト全体をコンパイルすることを選択します。 ビルドプロジェクトコマンドが実行されます。

  コンパイル中にエラーが発生すると、IntelliJ IDEA は実行 / デバッグ構成を開始しようとしません。

• ビルド、エラーチェックなし: ビルド オプションと同じですが、IntelliJ IDEA はコンパイル結果に関係なく実行 / デバッグ構成を開始しようとします。

• アーティファクトのビルド: このオプションを選択して、 アーティファクトを作成します。 開いたダイアログで、構築する必要のある 1 つまたは複数のアーティファクトを選択します。

• リモート外部ツールの実行: リモート SSH 外部ツールを追加します。

• Grunt タスクの実行: Grunt タスクを実行するには、このオプションを選択してください。

  表示される Grunt タスク ダイアログで、必要なタスクが定義されている Gruntfile.js を指定し、実行するタスクを選択して、Grunt ツールに渡す引数を指定します。

  Node.js ランタイムのロケーション、渡すパラメーター、および grunt-cli パッケージへのパスを指定します。

• gulp タスクの実行: Gulp タスクを実行するには、このオプションを選択してください。

  表示される Gulp タスク ダイアログで、必要なタスクが定義されている Gulpfile.js を指定し、実行するタスクを選択して、Gulp ツールに渡す引数を指定します。

  Node.js ランタイムのロケーション、それに渡すパラメーター、 gulp パッケージへのパスを指定します。

• Maven ゴールの実行: Maven ゴールを実行するには、このオプションを選択します。 開いたダイアログで、実行するゴールを選択します。

• npm スクリプトの実行: npm スクリプトを実行するには、このオプションを選択してください。

  開いた NPM スクリプト ダイアログで、 npm 実行 / デバッグ構成設定を指定します。

• TypeScript のコンパイル: 組み込み TypeScript コンパイラーを実行するように選択し、TypeScript コードに加えたすべての変更が生成された JavaScript ファイルに反映されるようにします。 表示される TypeScript のコンパイル設定 ダイアログで、 エラーの確認 チェックボックスを選択または選択解除して、エラーが検出された場合のコンパイラーの動作を設定します。

  • エラーの確認 チェックボックスが選択されていると、コンパイラーはすべてのエラーを表示し、実行構成は開始されません。

  • エラーの確認 チェックボックスがオフの場合、コンパイラーは検出されたすべてのエラーを表示しますが、実行構成は起動されます。

• CoffeeScript ソースマップの生成: CoffeeScript ソースのソースマップを生成するには、このオプションを選択してください。 表示されるダイアログで、CoffeeScript のソースファイルがある場所を指定します。

• Rake タスクの実行: 実行またはデバッグの前に実行される Rake タスクを追加します。 Rake タスクを選択するには、参照ボタン をクリックして、使用可能なタスクのリストから目的のタスクを選択します。

  コード補完はここから入手できることに注意してください。

  

• JRuby コンパイラーの実行: 指定されたターゲットパス、コンパイラープロセスヒープサイズ、コマンドラインパラメーター（存在する場合）を指定して JRuby コンパイラーを実行するには、このオプションを選択します。

Alt+Delete

このアイコンをクリックして、選択したタスクをリストから削除します。

Enter

選択したタスクを編集するには、このアイコンをクリックします。 開いたダイアログで必要な変更を加えます。

Alt+Up

Alt+Down

これらのアイコンをクリックして、選択したタスクをリスト内で 1 行上または下に移動します。 タスクは、リストに表示されている順に実行されます。

このページを表示する

実行 / デバッグ構成を実際に開始する前に、実行 / デバッグ構成設定を表示するには、このチェックボックスを選択します。

ツールウィンドウをアクティブにする

デフォルトではこのチェックボックスは選択されており、実行 / デバッグ構成を開始すると 実行または デバッグツールウィンドウが開きます。

それ以外の場合、チェックボックスがオフの場合、ツールウィンドウは非表示になります。 ただし、構成が実行されている場合は、 Alt+4 または Alt+5 を押すことにより、構成に対応するツールウィンドウを自分で開くことができます。