実行 / デバッグ構成: NPM

作成: 実行 | 実行構成の編集 | | NPM

このページでは、構成固有の項目と、すべての実行 / デバッグ構成に共通のオプションについて説明します。この構成の使用方法の詳細については、「npm、pnpm、Yarn」を参照してください。

このダイアログでは、npm(英語) および Yarn(英語) スクリプトをローカルで実行するための構成を作成します。現在のコンテキストにおける「ローカル」とは、WebStorm 自体がコンピューターにインストールされている Node.js を起動し、その後スクリプトの実行を開始することを意味します。

npm、pnpm、Yarn の詳細を参照してください。

スクリプトが開発モードでアプリケーションを起動する場合、構成を変更してデバッグセッションも開始することができます。これを行うには、ブラウザー / ライブ編集タブに移動し、アプリケーションが実行される URL アドレスを指定します。詳細については、単一の npm 実行 / デバッグ構成で Angular アプリケーションを実行およびデバッグする、単一の npm 実行 / デバッグ構成で Vue.js アプリケーションを実行およびデバッグする、単一の npm 実行 / デバッグ構成で Vite アプリケーションを実行およびデバッグするを参照してください。

始める前に

Node.js をダウンロードしてインストールします。npm もインストールされることに注意してください。使用する場合は、事前の手順は完了しています。
Yarn を使用するには、Yarn オフィシャル Web サイト(英語)の説明に従ってインストールしてください。

構成タブ

項目	説明
package.json	このフィールドでは、スクリプトの実行元となる package.json ファイルを指定します。現在のプロジェクトで検出されたすべての package.json ファイルを表示するドロップダウンリストからファイルを選択するか、をクリックして、開いたダイアログで必要な package.json を選択します。
コマンド	このリストから、実行する npm CLI コマンドを選択します。デフォルトでは、`run-script` が選択されています。詳細については、npm のドキュメント(英語)の CLI コマンドセクションを参照してください。
スクリプト	このドロップダウンリストから、選択したコマンドを適用するスクリプトを選択します。このリストには、package.json ファイルの `scripts` プロパティで定義されているすべてのスクリプトが含まれています。
引数	このフィールドで、スクリプトを実行するコマンドライン引数を指定します。詳細については、npm の公式 Web サイト(英語)を参照してください。
ノードランタイム	このフィールドでは、使用する Node.js ランタイムを指定します。プロジェクトエイリアスを選択した場合、WebStorm は JavaScript ランタイムページのノードランタイムフィールドにあるプロジェクトのデフォルトインタープリターを自動的に使用します。ほとんどの場合、WebStorm はプロジェクトのデフォルトランタイムを検出し、そのフィールドに自動的に入力します。別の構成済みのローカルインタープリターまたはリモートインタープリターを選択するか、をクリックして新しいインタープリターを構成することもできます。詳細については、「リモート Node.js ランタイムの構成」、「ローカル Node.js ランタイムの構成」、「Linux の Windows サブシステムで Node.js を使用する」を参照してください。
Node オプション	このフィールドに、Node.js 実行可能ファイルに渡される Node.js 固有のコマンドラインオプションを入力します。受け入れ可能なオプションは次のとおりです。実行中に CoffeeScript ファイルをオンザフライで JavaScript にコンパイルするには、`--require coffeescript/register` を使用します。このモードでは、`coffeescript` パッケージの一部である register.js ファイルがプロジェクト内に配置されている必要があります。CoffeeScript コンパイラーをインストールするの説明に従って、`coffeescript` パッケージがローカルにインストールされていることを確認してください。 Chrome デバッグプロトコル(英語)サポートには `--inspect` または `--inspect-brk` パラメーターを使用します。
パッケージマネージャー	このフィールドで使用するパッケージマネージャーを指定します。`Project` エイリアスを選択すると、PhpStorm は JavaScript ランタイムページのデフォルトのプロジェクトパッケージマネージャーを使用します。関連するパッケージのエイリアス (npm または yarn) を選択したり、パッケージマネージャーのカスタムインストールへの明示的なパスを指定したりすることもできます。
環境変数	このフィールドで、必要に応じて Node.js 実行可能ファイルの環境変数(英語)を指定します。フィールドの右側にある参照をクリックし、環境変数ダイアログで変数のリストを構成します。次のように開きます。新しい変数を定義するには、をクリックして、変数の名前と値を指定します。変数定義を破棄するには、リストでそれを選択してをクリックします。準備ができたら、OK をクリック変数の定義は、環境変数読み取り専用フィールドにセミコロンを区切り文字として表示されます。例: `NODE_PATH` : モジュール検索パスの前に付いたディレクトリの `:` -separated リスト。 `NODE_MODULE_CONTEXTS` : 独自のグローバルコンテキストでモジュールをロードするには 1 に設定します。 `NODE_DISABLE_COLORS` : REPL の色を無効にするには 1 に設定します。
Docker コンテナーの設定	この読み取り専用フィールドには、ポートとボリュームのバインディングが表示されます。をクリックして、コマンドプレビューを開きます。このフィールドは、Docker ベースのリモートインタープリターが選択されている場合にのみ表示されます。
Docker Compose	この領域では、Docker Compose に渡すコマンドとオプションを指定します。デフォルト設定を受け入れるか、「」をクリックしてカスタム設定 (たとえば、`--rm` や `--service-ports` などのカスタム Docker Compose フラグ) を指定します。詳細については、Docker オフィシャル Web サイト(英語)を参照してください。コマンドプレビューを確認してください。このフィールドは、Docker Compose 経由のリモートランタイムが選択された場合にのみ表示されます。

共通設定

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

項目	説明
名前	実行構成の名前を指定して、編集または実行時に他の構成の間ですばやく識別できるようにします。
複数のインスタンスを許可する	この実行構成の複数のインスタンスを並行して実行できるようにします。デフォルトでは無効になっており、別のインスタンスがまだ実行されているときにこの構成を開始すると、WebStorm は実行中のインスタンスを停止して別のインスタンスを開始することを提案します。これは、実行構成が多くのリソースを消費し、複数のインスタンスを実行する正当な理由がない場合に役立ちます。
プロジェクトファイルとして保存	実行構成設定を含むファイルを保存して、他のチームメンバーと共有します。デフォルトの場所は .idea/runConfigurations です。ただし、.idea ディレクトリを共有したくない場合は、プロジェクト内の他のディレクトリに構成を保存できます。デフォルトでは無効になっており、WebStorm は実行構成設定を .idea/workspace.xml に保存します。

項目

説明

名前

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

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

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

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

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

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

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

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

項目	ショートカット	説明
	`Alt+Insert`	実行 / デバッグ構成を作成します。
	`Alt+Delete`	選択した実行 / デバッグ構成を削除します。デフォルト設定は削除できません。
	`Ctrl+D`	選択した実行 / デバッグ構成のコピーを作成します。デフォルト設定のコピーを作成してください。
		このボタンは、一時的な構成を選択した場合にのみ表示されます。このボタンをクリックして、一時的な構成を永続的なものとして保存します。
		新しいフォルダーに移動 / 新しいフォルダーを作成します。実行 / デバッグ構成は、フォルダーに配置することでグループ化できます。フォルダーを作成するには、カテゴリ内の設定を選択し、をクリックしてフォルダー名を指定します。カテゴリだけにフォーカスがある場合は、空のフォルダーが作成されます。次に、設定をフォルダー内、フォルダー間、フォルダー外に移動するには、ドラッグまたはボタンとボタンを使用します。グループ化を解除するには、フォルダーを選択してをクリックします。
		このボタンをクリックすると、設定がアルファベット順にソートされます。

起動前

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

項目	ショートカット	説明
	`Alt+Insert`	このアイコンをクリックして、以下の使用可能なタスクのいずれかを追加します。 Web ブラウザーの起動 : ブラウザーを起動するにはこのオプションを選択します。開いたダイアログで、ブラウザーの種類を選択し、開始 URL を入力します。また、ブラウザーを JavaScript デバッガーで起動するかどうかを指定します。外部ツールの実行 : 外部アプリケーションを実行することを選択します。開いたダイアログで、実行する 1 つまたは複数のアプリケーションを選択します。WebStorm でまだ定義されていない場合は、定義を追加します。詳細については、「外部ツールおよび外部ツール」を参照してください。別の構成を実行 : 別の実行 / デバッグ構成を実行することを選択し、それが完了するまで待ってから現在の構成を開始します。複数の構成を並行して実行する場合は、複合実行 / デバッグ構成を使用してください。ファイル監視の実行 : WebStorm に現在アクティブなすべての File Watchers を適用させるには、このオプションを選択します。リモート外部ツールの実行 : リモート SSH 外部ツールを追加します。 Grunt タスクの実行 : Grunt タスクを実行するには、このオプションを選択してください。表示される Grunt タスクダイアログで、必要なタスクが定義されている Gruntfile.js を指定し、実行するタスクを選択して、Grunt ツールに渡す引数を指定します。 Node.js ランタイムの場所、それに渡すパラメーター、grunt-cli パッケージへのパスを指定します。 gulp タスクの実行 : Gulp タスクを実行するには、このオプションを選択してください。表示される Gulp タスクダイアログで、必要なタスクが定義されている Gulpfile.js を指定し、実行するタスクを選択して、Gulp ツールに渡す引数を指定します。 Node.js ランタイムの場所、それに渡すパラメーター、gulp パッケージへのパスを指定します。 npm スクリプトの実行 : npm スクリプトを実行するには、このオプションを選択してください。開いた NPM スクリプトダイアログで、npm 実行 / デバッグ構成設定を指定します。 TypeScript のコンパイル : 組み込み TypeScript コンパイラーを実行するように選択し、TypeScript コードに加えたすべての変更が生成された JavaScript ファイルに反映されるようにします。表示される TypeScript のコンパイル設定ダイアログで、エラーの確認チェックボックスを選択または選択解除して、エラーが検出された場合のコンパイラーの動作を設定します。エラーの確認チェックボックスが選択されていると、コンパイラーはすべてのエラーを表示し、実行構成は開始されません。エラーの確認チェックボックスがオフの場合、コンパイラーは検出されたすべてのエラーを表示しますが、実行構成は起動されます。 CoffeeScript ソースマップの生成 : CoffeeScript ソースのソースマップを生成するには、このオプションを選択してください。表示されるダイアログで、CoffeeScript のソースファイルがある場所を指定します。
	`Alt+Delete`	このアイコンをクリックして、選択したタスクをリストから削除します。
	`Enter`	選択したタスクを編集するには、このアイコンをクリックします。開いたダイアログで必要な変更を加えます。
	`Alt+Up` `Alt+Down`	これらのアイコンをクリックして、選択したタスクをリスト内で 1 行上または下に移動します。タスクは、リストに表示されている順に実行されます。
このページを表示する		実行 / デバッグ構成を実際に開始する前に、実行 / デバッグ構成設定を表示するには、このチェックボックスを選択します。
ツールウィンドウをアクティブにする		デフォルトではこのチェックボックスは選択されており、実行 / デバッグ構成を開始すると実行またはデバッグツールウィンドウが開きます。それ以外の場合、チェックボックスがオフの場合、ツールウィンドウは非表示になります。ただし、構成が実行されている場合は、`Alt+4` または `Alt+5` を押すことにより、構成に対応するツールウィンドウを自分で開くことができます。

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

実行 / デバッグ構成でアプリケーションを開発モードで起動し、同時にデバッグセッションを開始する場合は、このタブのコントロールを使用します。詳細については、単一の npm 実行 / デバッグ構成で Angular アプリケーションを実行およびデバッグする、単一の npm 実行 / デバッグ構成で Vue.js アプリケーションを実行およびデバッグする、単一の npm 実行 / デバッグ構成で Vite アプリケーションを実行およびデバッグするを参照してください。

ここで、WebStorm を有効にして、ブラウザーでアプリケーションを開くこともできます。

項目	説明
ブラウザーを開く	この領域では、アプリケーションをブラウザーで開くことを有効にします。起動後 - 起動時にアプリケーションを開くには、このチェックボックスをオンにします。リストから、アプリケーションを開くブラウザーを選択します。アプリケーションをデバッグする場合は、Google Chrome(英語) または別の Chromium ベースのブラウザー(英語)を選択します。 URL - このフィールドに、アプリケーションが実行される URL アドレスを指定します。 JavaScript デバッガーを使用 - アプリケーションが開発モードで起動されると同時にデバッグセッションを開始するには、このチェックボックスをオンにします。

項目

説明

ブラウザーを開く

この領域では、アプリケーションをブラウザーで開くことを有効にします。

起動後 - 起動時にアプリケーションを開くには、このチェックボックスをオンにします。リストから、アプリケーションを開くブラウザーを選択します。
アプリケーションをデバッグする場合は、Google Chrome(英語) または別の Chromium ベースのブラウザー(英語)を選択します。
URL - このフィールドに、アプリケーションが実行される URL アドレスを指定します。
JavaScript デバッガーを使用 - アプリケーションが開発モードで起動されると同時にデバッグセッションを開始するには、このチェックボックスをオンにします。

2026 年 3 月 09 日