IntelliJ IDEA 2021.1 ヘルプ

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

実行 | 実行構成の編集 | Add New Configuration | Node.js

次の Node.js バージョンが IntelliJ IDEA 2020.3 でサポートされています。

  • Node.js 10

  • Node.js 12

  • Node.js 14

  • Node.js 15

サポートされている Node.js バージョンの詳細を参照してください。

このダイアログで、コンピューター上の Node.js アプリケーションと一緒にデバッガーを開始するための構成を作成します。

始める前に

  1. Node.js(英語) をダウンロードしてインストールします。

  2. JetBrains リポジトリからプラグインをインストールする説明に従って、Node.js プラグインを設定 / 環境設定 | プラグインページにインストールします。

構成タブ

項目 説明
Node インタープリター このフィールドに、使用する Node.js インタープリターを指定します。これはローカルまたはリモート Node.js インタープリターまたは Windows Subsystem for Linux の Node.js(英語) です。リストからインタープリターを選択するか、または the Browse button をクリックして表示されるダイアログで新しいインタープリターを設定します。
Node パラメーター

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

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

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

  • Node.js v7 を Chrome デバッグプロトコル(英語)サポートに使用している場合は、--inspect または --inspect-brk パラメーターを使用します。それ以外の場合、デフォルトでデバッグプロセスは V8 デバッグプロトコル(英語)を使用します。

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

作業ディレクトリ このフィールドでは、アプリケーションの作業ディレクトリ(英語)を指定します。デフォルトでは、フィールドにはプロジェクトのルートフォルダーが表示されます
JavaScript ファイル このフィールドには、それを開始するアプリケーションのメインファイルへのパスを指定します(たとえば、Express(英語) アプリケーションの場合は bin/www)。

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

アプリケーションパラメーター このフィールドに、起動時に process.argv(英語) 配列を介してアプリケーションに渡される Node.js 固有の引数を入力します。
環境変数 このフィールドで、必要に応じて Node.js 実行可能ファイルの環境変数(英語)を指定します。フィールドの右側にある参照 the Browse button をクリックし、環境変数ダイアログで変数のリストを構成します。次のように開きます。
  • 新しい変数を定義するには、the Add button をクリックして、変数の名前と値を指定します。

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

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

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

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

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

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

Docker コンテナー設定

the Browse button をクリックしてダイアログを開き、以下の設定を指定します。

オプション
  • ネットワークを無効にする : ネットワークを無効にするには、このチェックボックスを選択します。これは --net="none" に対応します。つまり、コンテナー内では外部ネットワークリソースは利用できません。

  • ネットワークモード : オプション --net の他の値に対応します。
    • bridge がデフォルト値です。ブリッジのネットワーク上のコンテナーに IP アドレスが割り当てられ、トラフィックはこのブリッジを経由してコンテナーにルーティングされます。
      コンテナーはデフォルトで IP アドレスを介して通信できます。名前で通信するには、リンクする必要があります。

    • host : コンテナー内のホストのネットワークスタックを使用します。

    • container:<name|id> : 名前または ID で指定された別のコンテナーのネットワークスタックを使用してください。

    詳細はネットワーク設定(英語)のドキュメントを参照してください。

  • リンク : このセクションを使用して、作成するコンテナーを他のコンテナーとリンクします。これは Network mode = bridge に適用され、--link オプションに対応します。

  • すべてのポートを公開する : すべてのコンテナーポートをホストに公開します。これはオプション --publish-all に対応します。

  • ポートバインディング : ポートバインディング(英語)のリストを指定します(英語)docker run-p オプションを使用するのと同様です。

  • 追加ホスト : これは --add-host オプションに対応します。詳細は /etc/hosts の管理(英語)ページを参照ください。

  • ボリュームバインディング : このフィールドを使用して、Docker デーモンが実行されるコンピューターの特別なフォルダーボリュームとフォルダー間のバインディングを指定します。これは -v オプションに対応します。
    詳細については、コンテナー内のデータを管理する(英語)を参照してください。

  • 環境変数 : このフィールドを使用して、環境変数とその値のリストを指定します。これは -e オプションに対応します。詳細は ENV (環境変数)(英語) ページを参照ください。

Icons actions move down をクリックしてテーブルを展開します。Icons general addIcons general remove、または Icons actions edit をクリックしてリストを作成します。

自動構成

IntelliJ IDEA でコンテナー設定を構成するには、このチェックボックスを選択します。自動設定モードの場合:

  • IntelliJ IDEA は新しいイメージを作成し、そこに npm モジュールをインストールします。

  • IntelliJ IDEA は、コンテナーを新しいイメージで実行し、プロジェクトフォルダーをコンテナー内の /opt/project フォルダーにバインドして、更新時の同期を確保し、/opt/project/node_modules を OS 一時ディレクトリにマップします。

自動設定でも、アプリケーションが実行されているポートをコンテナーのポートとバインドする必要があります。これらの公開ポートは Docker ホストの IP アドレス(デフォルトでは 192.168.99.100)で利用可能です。Express アプリケーションのクライアント側をデバッグするときは、このようなバインディングが必要です。この場合は、コンピューターからブラウザーを開き、アプリケーションで指定されているポートを介してコンテナーホストのアプリケーションにアクセスする必要があります。

ポートバインドを構成する

  1. Docker コンテナー設定フィールドで the Browse button をクリックし、表示される Docker コンテナー設定の編集ダイアログでポートバインディング領域を展開します。

  2. the Add button をクリックし、開いているポートバインディングダイアログで、次のようにポートをマッピングします。

    • コンテナーポート」フィールドに、アプリケーションで指定されているポートを入力します。

    • ホストポートフィールドに、コンピューターのブラウザーでアプリケーションを開くときに経由するポートを入力します。

    • ホスト IP フィールドに、Docker のホストの IP アドレスを入力します。デフォルト IP は 192.168.99.100 です。ホストは、設定 / 環境設定ダイアログDocker ページAPI URL フィールドで指定されます。

    • OK をクリックして Docker コンテナー設定の編集ダイアログに戻り、新しいポートマッピングがリストに追加されます。

  3. OK をクリックして実行 / デバッグ構成: Node.js ダイアログに戻ります。

ブラウザー / ライブ編集タブ

このタブで、ブラウザーの動作を設定し、アプリケーションのクライアント側コードのデバッグを有効にします。この機能は JavaScript Debug 実行構成によって提供されるため、技術的には、IntelliJ IDEA はサーバー側とクライアント側のコードに対して別々の実行構成を作成しますが、すべての設定を 1 つの専用 Node.js 実行構成で指定します。

項目

説明

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

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

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

  • カスタムブラウザーを使用するには、リストからそれを選択します。ライブ編集は Chrome でのみ完全にサポートされていることに注意してください。

  • ブラウザーを設定するには、the Browse button をクリックして、表示されるウェブブラウザーダイアログで設定を調整します。詳しくは、ウェブブラウザーを参照してください。

JavaScript デバッガーを使用する

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

V8 プロファイリングタブ

このタブで V8 CPU とメモリのプロファイリングを有効にします。

項目 説明
CPU プロファイル情報を記録する アプリケーションの起動時に CPU プロファイリングデータの記録を開始するには、このチェックボックスをオンにします。下の領域のコントロールが有効になります。以下を指定してください。
  • ログフォルダー : このフィールドでは、記録されたログを保存するフォルダーを指定します。プロファイリングデータはログファイル isolate-<session number> に保存されます。

  • すべての隔離(V8 インスタンス)に対して一つのログファイル : このチェックボックスを選択すると、すべての V8 インスタンスに対して 1 つのログファイル(したがって 1 つのプロファイリング結果ビュー)のみが作成されます。インスタンスごとに別々のファイルを作成するには、チェックボックスをオフにします。Node.js は追加の V8 インスタンスを作成できます。デバッグプロセス用。

ヒープスナップショットの取得を許可する メモリプロファイリングを実行する場合は、このチェックボックスを選択してください。

ログタブ

このタブで、実行ツールウィンドウのコンソールタブに morgan (英語) などのログツールによって生成された情報を表示できるようにします。詳細については、Node.js アプリの実行時にログを管理するを参照してください。

共通

実行構成を編集するとき(ただし実行構成テンプレートは編集しないとき)、次のオプションを指定できます。

項目

説明

名前

実行 / デバッグ構成の名前を指定して、たとえば実行ポップアップ Alt+Shift+F10 から構成を編集または実行するときにすばやく識別します。

並列実行を許可する

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

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

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

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

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

ツールバー

実行 / デバッグ構成のツリー表示には、プロジェクトで使用可能な構成を管理したり、デフォルトの構成テンプレートを調整したりするのに役立つツールバーがあります。

項目 ショートカット 説明
the Add button Alt+Insert 実行 / デバッグ構成を作成します。
the Remove button Alt+Delete 選択した実行 / デバッグ構成を削除します。デフォルト設定は削除できません。
Copy Ctrl+D 選択した実行 / デバッグ構成のコピーを作成します。デフォルト設定のコピーを作成してください。
Save configuration このボタンは、一時的な構成を選択した場合にのみ表示されます。このボタンをクリックして、一時的な構成を永続的なものとして保存します。
Edit Templates テンプレート(つまり、デフォルトの実行 / デバッグ構成設定)を表示および編集します。テンプレートはテンプレートノードに表示され、新しく作成された構成に使用されます。
Method up / Method down Alt+Up / Alt+Down

選択した実行 / デバッグ構成をリスト内で上下に移動します。

リスト内の設定の順序によって、実行 / デバッグ構成を選択したときに表示される設定の順序が決まります。

実行 / デバッグ構成のデフォルトのテンプレートは、常にアルファベット順にソートされています。

Move into new folder / Create new folder

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

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

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

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

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

起動前

この領域では、選択した実行 / デバッグ構成を開始する前に実行するタスクを指定できます。タスクは、リストに表示されている順序で実行されます。

項目 ショートカット 説明
the Add button Alt+Insert

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

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

  • 別の構成を実行 : 別の実行 / デバッグ構成を実行することを選択します。開いたダイアログで、実行する設定を選択します。

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

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

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

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

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

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

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

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

  • 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 実行 / デバッグ構成設定を指定します。
  • React Native Bundler の起動 : このオプションを選択すると、実行中またはデバッグ中のセッションの一部として、バンドラーが自動的に実行されます。デフォルトでは、これは react-native start を介して行われます。アプリケーションで Expo(英語) を使用している場合は、start npm タスクを介して開発サーバーを実行する必要があります。これを行うには、Add をクリックし、次に React Native の設定ダイアログで npm スクリプトを選択して、リストから開始を選択します。

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

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

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

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

  • リモートホストにファイルをアップロードする : このオプションを選択すると、デフォルトのサーバーアクセス構成に従って、アプリケーションファイルが自動的にサーバーにアップロードされます。

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

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

    コード補完はこちらから入手できます。

    Code completion for the Rake tasks

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

the Remove button Alt+Delete このアイコンをクリックして、選択したタスクをリストから削除します。
Edit Enter 選択したタスクを編集するには、このアイコンをクリックします。開いたダイアログで必要な変更を加えます。
Method up / Method down Alt+Up / Alt+Down これらのアイコンをクリックして、選択したタスクをリスト内で 1 行上または下に移動します。タスクは、リストに表示されている順に実行されます。
このページを表示する 実行 / デバッグ構成を実際に開始する前に、実行 / デバッグ構成設定を表示するには、このチェックボックスを選択します。
ツールウィンドウをアクティブにする

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

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

関連ページ:

プラグインを管理する | IntelliJ IDEA

プラグインは以下に示すように IntelliJ IDEA のコア機能を拡張します。バージョン管理システム、アプリケーションサーバー、およびその他のツールとの統合を提供する、さまざまな言語とフレームワークのコーディング支援サポートを追加する、ショートカットヒント、ライブプレビュー、ファイルウォッチャーなどで生産性を向上、コーディング演習と検証で新しいプログラミング言語を学ぶのに役立ちます、プラグイン設定を開く設定 / 環境設定ダイアログで、プラグインを選択します。マーケットプレースタブを使用して...

サポートされている Node.js バージョン | IntelliJ IDEA

このページには、アプリケーション開発のために IntelliJ IDEA でサポートされているすべての Node.js バージョンが一覧表示されます。Node.js 公式 Web サイトでのリリースのステータスに関する情報とともに、Node.js のリリーススケジュールを見つけてください。次の Node.js バージョンが IntelliJ IDEA 2020.3 でサポートされています。Node.js 10、Node.js 12、Node.js 14、Node.js 15、Node.js のア...

Node.js | IntelliJ IDEA

Node.js は、ブラウザーの外部、たとえばサーバーやコマンドラインで JavaScript を実行するための軽量なランタイム環境です。IntelliJ IDEA は Node.js と統合し、アプリケーションの構成、編集、実行、デバッグ、テスト、プロファイリング、メンテナンスを支援します。Node.js がアプリケーションのローカルランタイムとして、または npm パッケージの管理、JavaScript リンターの実行、ツールのビルド、フレームワークのテストなどにのみ必要な場合は、Node.j...

CoffeeScript | IntelliJ IDEA

IntelliJ IDEA では、JavaScript にコンパイルされた CoffeeScript を使用できます。IntelliJ IDEA は *.coffee ファイルを認識し、でマークします。CoffeeScript コードでブレークポイントを直接設定でき、IntelliJ IDEA はコンパイル時に生成されたソースマップを使用してブレークポイントを認識します。IntelliJ IDEA は、キーワード、ラベル、変数、パラメーター、関数の補完を提案することにより、CoffeeScript コー...

Docker | IntelliJ IDEA

Docker を使用すると、開発者は、本番環境と同じ環境でコードをテストするために、コンテナー内にアプリケーションをデプロイできます。IntelliJ IDEA は、Docker プラグインを使用して Docker サポートを提供します。プラグインは IntelliJ IDEA Ultimate Edition にバンドルされており、デフォルトで有効になっています。IntelliJ IDEA Community Edition の場合、プラグインを管理するに従って Docker プラグインをインスト...

設定 / 「設定」ダイアログ | IntelliJ IDEA

設定ダイアログでは、IntelliJ IDEA の動作と外観を制御できます。ダイアログの左上部分にある検索フィールドを使用して、目的のオプションを見つけます。あるいは、検索ボックスにあるカテゴリの階層リスト(設定のグループ)を使用して設定を参照することもできます。このページでは、ダイアログの主なコントロールの説明を見つけます。検索テキスト領域に検索キーワードを入力します。検索文字列を入力している間、ダイアログのオプションのリストは、一致する出現箇所に縮小されます。検索エリアをクリアするには、この...