WebStorm 2026.1 Help

npm、pnpm、Yarn

WebStorm は npmpnpmYarnYarn 2 、Yarn 3、および Bun と連携しています。 IDE 内の組み込み ターミナル から、再利用可能なコードパッケージのインストール、検索、更新、削除ができます。

WebStorm でも npm、Yarn、pnpm スクリプトを実行およびデバッグできます。 WebStorm は package.json ファイルを解析してスクリプトの定義を認識し、それらをツリービューに表示して、ツリー内のスクリプトと package.json ファイル内のその定義の間でナビゲートできます。 詳細については、 npm(英語)Yarn(英語)pnpm (英語) の公式 Web サイトを参照してください。

WebStorm は、 Yarn ワークスペースを使用しているプロジェクトを検出し、プロジェクト分析時に、ワークスペース内の package.json ファイルにリストされているが、ルート node_modules フォルダーに存在するすべての依存関係をインデックスします。

WebStorm は、異なる package.json ファイルにリストされているがルートの node_modules フォルダーに保存されているすべての依存関係をインデックスする

始める前に

  • Node.js をダウンロードしてインストールします。 npm もインストールされているため、これを使用する場合は、前の手順を完了してください。

  • Yarn を使用するには、 Yarn オフィシャル Web サイト(英語)の説明に従ってインストールしてください。

  • pnpm を使用するには、埋め込まれた ターミナルAlt+F12 )を開き、次のように入力します。

    npm install --g pnpm

    詳細については、 pnpm 公式 Web サイト(英語)を参照してください。

  • Bun を使用するには、 Bun オフィシャル Web サイト(英語)の説明に従ってインストールしてください。

プロジェクトパッケージマネージャーを選択する

WebStorm では、プロジェクトで npm、Yarn、Yarn 2、Bun、pnpm のいずれを使用するか選べます。

デフォルトで、WebStorm は npm を提案します。 ただし、 yarn.lock ファイルがあるプロジェクトを開いていて、Yarn がコンピューターにインストールされている場合、WebStorm はこのプロジェクトのパッケージマネージャーを自動的に Yarn に切り替えます。

pnpm-lock ファイルがあるプロジェクトを開いていて、pnpm がコンピューターにインストールされている場合、WebStorm はこのプロジェクトのパッケージマネージャーを自動的に pnpm に切り替えます。

プロジェクトに bun.lock または bun.lockb ファイルが含まれていて、Bun がコンピューターにインストールされている場合、WebStorm はそのプロジェクトで npm の代わりに Bun を使うことを提案します。

Yarn 1 または pnpm をデフォルトの WebStorm パッケージマネージャーとして設定することもできます。

  1. 設定 ダイアログ(Ctrl+Alt+S )で 言語 & フレームワーク | JavaScript ランタイム に移動します。 JavaScript ランタイムページが開きます。

  2. パッケージマネージャー フィールドで、プロジェクトのパッケージマネージャーを指定します。

    プロジェクトパッケージマネージャーを選択: システムのデフォルトインストールを選択する
    • システムのデフォルトのインストールを使用するには、 npmyarnpnpm 、または Bun を選択します。

    • パッケージマネージャーのカスタムインストールを使用するには、 選択 をクリックし、関連するパッケージマネージャーのインストールフォルダーを選択します。

      プロジェクトパッケージマネージャーを選択: カスタムインストールを選択する

    Project エイリアスを パッケージマネージャー リストで選択すると、WebStorm は Run/Debug Configuration: NPM ダイアログ内で選択したパッケージマネージャーを自動的に使用します。 npm/Yarn/pnpm スクリプトを実行したり 'npm install' を実行/'yarn install' を実行/「pnpm install」を実行 コマンドを呼び出したりする度に、WebStorm は選択したパッケージマネージャーへのパスも利用します。 詳細は、 スクリプトの実行とデバッグを参照してください。

新しいプロジェクトのデフォルトの WebStorm パッケージマネージャーを設定する

  1. 新規プロジェクトの設定 ダイアログ(ファイル | 新規プロジェクトのセットアップ | 設定 for New Projects )を開き、 言語 & フレームワーク | JavaScript ランタイム に進みます。

  2. 開いた Node.js および NPM ページで、リストから必要なパッケージマネージャーを選択します。

その後、WebStorm は新しいプロジェクト作成時に、選択したパッケージマネージャーをデフォルトとして提案します。

プロジェクトで Yarn 2 を設定する

  1. Yarn 1 がグローバルにインストールされていることを確認し、 Yarn オフィシャル Web サイト(英語)の説明に従って、プロジェクトで Yarn 2 を有効にします。 埋め込まれた ターミナル Alt+F12 を使用して、コマンドを入力します。

  2. 設定 ダイアログ(Ctrl+Alt+S )で、 言語 & フレームワーク | JavaScript ランタイム に移動し、 パッケージマネージャー リストからプロジェクト内の Yarn 2 パッケージへのパスを選択します。

package.json を編集

WebStorm は package.json ファイル内でプロジェクトの依存関係を扱うのを支援し、強力なコーディングサポートを提供します。

  • パッケージ名のコード補完。

    パッケージ名についてはコード補完
  • 利用可能な最新パッケージバージョンの情報。

    利用可能な最新のパッケージバージョンを表示する
  • npm install <package>@<version> または yarn add <package>@<version> を介してインストールできるバージョンの範囲に関する情報。 ` npm install または yarn install を実行すると、この範囲から入手可能な最新バージョンがインストールされます。

    Ctrl を押してバージョンにマウスオーバーすると、ツールチップに情報が表示されます。 セマンティックバージョニングの詳細については、 npm の公式ドキュメント(英語)を参照してください。

    利用可能なパッケージバージョンの範囲を表示する
  • 指定したバージョンのパッケージがインストール済みかどうかの表示および利用可能な最新バージョンの情報

    パッケージのバージョンがインストールされているかどうかの情報
  • 以前のパッケージバージョンのコード補完。 Ctrl+Space を押すか、最新バージョン以外を入力し始めると、WebStorm がすべての過去バージョンのパッケージ候補リストを表示します。

    以前のパッケージバージョンのコード補完
  • パッケージのクイックドキュメント検索。

    パッケージのクイックドキュメント検索

パッケージのインストールと更新

ご存じのとおり、npm ではパッケージを グローバルプロジェクト依存関係開発依存関係としてインストールできます。詳しくは npm 公式サイトをご参照ください。

pnpm もパッケージを グローバルプロジェクト依存関係開発依存関係としてインストールできます。詳しくは pnpm 公式サイトを参照してください。

Yarn を使用すると、パッケージを グローバル(英語)にインストールすることも、 プロジェクトの依存関係としてインストールすることもできます。 詳細については、 Yarn オフィシャル Web サイト(英語)を参照してください。

WebStorm では、エディター、 package.json ファイル、組み込みの ターミナル Alt+F12 、または JavaScript ランタイムページからパッケージをインストールできます。

package.json から

プロジェクトの依存関係をインストールする

  • ポップアップで 'npm install' を実行'yarn install' を実行「pnpm install」を実行 リンクをクリックします。

    依存関係ポップアップをインストールする

    WebStorm は依存関係がまだインストールされていない場合や変更があった場合に、このポップアップを表示します。 ポップアップを閉じるか 今後このメッセージを表示しない を選択してポップアップをオフにしても、 「<package_manager> install」を実行 アクションまたは 内蔵ターミナルを使用して依存関係をインストールできます。

    WebStorm が Node.js ランタイムを検出できない場合、エラーは JavaScript ランタイム ページへのリンク付きのポップアップで報告され、そこで Node.js インタープリターの構成ができます。

    Node.js が見つかりません

    この通知を誤って閉じてしまい、元に戻したい場合は、 Ctrl+Shift+A を押して Enable notifications と入力し始め、リストから package.json から依存関係のインストールに関する通知を有効化する。 を選択します。

  • または、関連する package.json ファイルをエディターで開くか、 プロジェクト ツールウィンドウで選択して、コンテキストメニューから 'npm install' を実行 を選択します。

プロジェクトの依存関係を更新する

  • ポップアップで 「<package manager> install」を実行 をクリックします。

    依存関係の更新: ポップアップ

    プロジェクトを開く、バージョン管理から更新、または package.json の編集時に、WebStorm はこのポップアップを毎回表示します。

  • WebStorm では、 dependencies または devDependencies にあるパッケージがインストール済みか、バージョンが指定範囲と一致するかもインスペクションで確認します。 インスペクションが不一致を検出した場合、クイックフィックスを提案します。 適用するには、 「<package manager> install」を実行 リンクをクリックします。

    インストールされているパッケージのバージョンが最新ではありません
  • 新しいバージョンのあるパッケージも WebStorm で検出し、バージョンにマウスオンするとクイックフィックスが利用できます。

    パッケージを最新バージョンに更新する: ツールチップ

    または、 Alt+Enter を押して、リストから <package> を最新バージョンに更新する を選択します。

    パッケージを最新バージョンに更新する: クイックフィックス

内蔵ターミナル

埋め込まれた ターミナルAlt+F12 )で、次のいずれかのコマンドを入力します。

  • グローバルインストールの場合:

    • npm install&#xa0;--global <package_name>

    • yarn global add <package_name>

    • pnpm --global add <package_name>

  • パッケージをプロジェクト依存関係または開発依存関係としてインストールするには:

    • npm install&#xa0;--save <package_name> または npm install&#xa0;--save-dev <package_name>

    • yarn add <package_name> --dev

    • pnpm add --save-dev <package_name>

package.json ファイルにリストされているすべての依存関係をインストールする

埋め込まれた ターミナルAlt+F12 )で、次のいずれかのコマンドを入力します。

  • npm install

  • yarn install

  • pnpm install

その結果、現在のフォルダーから package.json にリストされているすべての依存関係を取得します。 package.json の編集から詳細を参照してください。

脆弱なパッケージを検出する

WebStorm は、 Mend.io 脆弱性データベースおよび National Vulnerability Databaseを参照し、プロジェクトで使われているパッケージの脆弱性を検出します。 コードを作成すると、IDE は脆弱性があると考えられるパッケージをハイライトし、その説明を提供し、可能な場合は修正を提案します。 検出された脆弱なパッケージのリスト全体が 問題 ツールウィンドウに表示されます。

脆弱性チェックは、 脆弱な宣言済み依存関係 コードインスペクションパッケージチェッカープラグインを利用して処理します。 このプラグインは Mend.io(英語) によって提供されています。 このプラグインは WebStorm にバンドルされており、デフォルトで有効化されています。 関連機能が利用できない場合は、プラグインを無効化していないことを確認してください。 詳細については、 プラグイン設定を開く。 を参照してください。

Detect vulnerable packages and fix them in the editor

エディターでパッケージの脆弱性の問題を解決する

  • package.json ファイル内のハイライトされたパッケージにマウスを置きます。 ポップアップツールウィンドウには、検出された脆弱性の説明が表示されます。

  • クイックフィックスを適用するには、 その他のアクション Alt+Enter をクリックして、関連する提案を選択します。

問題ツールウィンドウで脆弱なパッケージを表示する

  1. インスペクションウィジェットで Problems アイコン をクリックします。

  2. 問題 ツールウィンドウの ファイル タブには、アクティブなエディタータブで開かれている package.json の脆弱なパッケージがすべてリストされます。 各項目には説明が付いています。

    問題を解決するには、リストで脆弱なパッケージを選択し、ツールバーの Yellow bulb アイコン をクリックするか、 Alt+Enter を押して、関連する提案を選択します。

  3. 脆弱性のある依存関係 タブには、プロジェクト内で検出されたすべての脆弱なパッケージがリストされます。

    問題ツールウィンドウ: 「脆弱な依存関係」タブ

    問題を修正するには、リストで脆弱なパッケージを選択し、右側のペインで 安全なバージョンをクリップボードにコピー リンクをクリックし、コピーしたバージョンを package.json に貼り付けます。

    詳しくは 結果の取得と問題の解決 を参照してください。

パッケージの脆弱性チェックを無効にする

デフォルトでパッケージの脆弱性チェックが有効になっています。

  • これをオフにするには、 設定 ダイアログ (Ctrl+Alt+S) を開き、 エディター | インスペクション に移動し、 セキュリティ ノードの 脆弱な宣言済みの依存関係 インスペクションの横にあるチェックボックスをオフにします。

  • あるいは 設定 ダイアログ(Ctrl+Alt+S )を開いて プラグイン に進み、 パッケージチェッカー プラグインを探して 無効化する をクリックします。

    Package Checker プラグインを無効にする

スクリプト実行

npm、Yarn、pnpm スクリプトは、エディターの package.json ファイルから、専用の npm ツールウィンドウのスクリプトツリーから、専用の実行構成に従って、または start-up または before-launch タスクとして自動的に起動できます。

スクリプト実行結果は Run ツールウィンドウに表示されます。 ツールウィンドウには、npm または Yarn スクリプトの出力、エラーの報告、見つからなかったパッケージまたはプラグインの一覧などが表示されます。 最後に実行されたスクリプトの名前がツールウィンドウのタイトルバーに表示されます。

スクリプトのデバッグセッションを開始すると、WebStorm は デバッグツールウィンドウを開きます。ここで、 スクリプトをステップ実行したり、スクリプトの実行を 停止および再開したり、 中断されたときにスクリプトを確認したり、 デバッガーコンソールで JavaScript コードスニペットを実行したりできます。

package.json からスクリプトを実行する

WebStorm では package.json ファイルから単一スクリプトをすばやく起動できます。 いくつかのスクリプトを実行またはデバッグするには、実行構成または npm ツールウィンドウを使用します。

  • エディターで該当する package.json ファイルを開き、スクリプトの横にあるガター内の Run ボタン をクリックし、コンテキストメニューから 実行 <script_name> を選択します。

    package.json からスクリプトを実行 / デバッグする
  • Ctrl+Shift+F10 を押してスクリプトを実行することもできます。

スクリプトの出力は、 実行 ツールウィンドウに表示されます。

デバッグモードでスクリプトを起動すると、WebStorm は デバッグツールウィンドウを開きます。ここで、 スクリプトのステップ実行、スクリプトの実行の 停止と再開中断時の検査デバッガーコンソールでの JavaScript コードスニペットの実行などを行うことができます。

npm ツールウィンドウからスクリプトを実行する

プロジェクト ツールウィンドウ(Alt+1 )で package.json ファイルを選択するか、エディターでファイルを開いてコンテキストメニューから npmスクリプトの表示 を選択すると、 npm ツールウィンドウが開きます。

npm、pnpm、Yarn を呼び出すとすぐに、ツールは、呼び出された package.json ファイルの scripts プロパティ内で定義されたスクリプトのツリーの構築を開始します。

プロジェクトに複数の package.json ファイルがある場合は、それらごとに個別のスクリプトツリーを構築し、以前に構築したツリーを削除せずにスクリプトを実行できます。 各ツリーは個別のノードに表示されます。

npm ツールウィンドウがまだ開いていない場合は開く

  • プロジェクト ツールウィンドウ(Alt+1 )で必要な ファイルを選択するか、エディターでファイルを開き、コンテキストメニューから npmスクリプトの表示 を選択します。

    nmp ツールウィンドウを開く

    npm ツールウィンドウが開き、選択または開いた package.json ファイルに従って作成されたスクリプトツリーが表示されます。

すでに開いている npm ツールウィンドウでスクリプトのツリーを構築する

  1. npm ツールウィンドウで、ツールバーの 追加ボタン をクリックし、リストから必要な package.json ファイルを選択します。 デフォルトで WebStorm はプロジェクトのルートの package.json ファイルを表示します。

  2. 別の package.json ファイルがある場合は、 package.json を選択する をクリックして表示されるダイアログで必要な package.json ファイルを選択します。 WebStorm は、選択した package.json ファイルのパスがタイトルになった新しいノードを追加し、その下にスクリプトのツリーを作成します。

別のスクリプトツリーを構築する

ツリーを再構築する

  • 必要なノードに切り替えて、ツールバーの スクリプトを再読み込み をクリックします。

ツリー内のスクリプトを名前でソートする

  • ツールバーの 設定 をクリックし、メニューから 並べ替え を選択してから、 名前 を選択します。

    デフォルトでは、ツリーには、 package.json (オプション 定義順序 )で定義されている順序でスクリプトが表示されます。

1 つのスクリプトを実行する

  • スクリプトをダブルクリックしてください。

  • ツリーでスクリプトを選択して Enter を押すか、コンテキストメニューから <スクリプト名>を実行 を選択します。

いくつかのスクリプトを実行する

  • 複数選択モードを使用します:隣接するアイテムの場合は Shift キーを、隣接しないアイテムの場合は Ctrl キーを押しながら、必要なスクリプトを選択し、選択のコンテキストメニューから 実行 または デバッグ を選択します。

    複数のスクリプトを実行する

実行構成によるスクリプトの実行

エディターまたは npm ツールウィンドウでスクリプトの実行やデバッグを行うと、WebStorm が 一時的な実行構成を自動作成します。 使用する以外に、独自の npm 実行構成を作成して起動できます。

NPM の実行 / デバッグ構成を作成する

  1. 実行 | 実行構成の編集 に進みます。 または、ツールバーの 実行 ウィジェットから 実行構成の編集 を選択します。

    構成の編集を開くダイアログ
  2. 開いた 実行構成の編集 ダイアログで、ツールバーの 追加 ボタン (追加ボタン) をクリックし、リストから npm を選択します。 実行 / デバッグ構成: npm ダイアログが開きます。

  3. 実行する CLI コマンド、実行するスクリプト(区切り文字として空白を使用)、およびこれらのスクリプトが定義されている package.json ファイルの場所を指定します。 必要に応じて、スクリプトを実行するための コマンドライン引数(英語)を入力します。

  4. パッケージマネージャーのコマンドラインインターフェースの詳細については、 npm 公式 Web サイト(英語)および Yarn オフィシャル Web サイト(英語)を参照してください。

  5. 使用する Node.js ランタイムを指定します。

    プロジェクト エイリアスを選択した場合、WebStorm は JavaScript Runtime ページの ノードランタイム フィールドにあるプロジェクトのデフォルトインタープリターを自動的に使用します。 ほとんどの場合、WebStorm はプロジェクトのデフォルトランタイムを検出し、自動的にフィールドに入力します。

    別の構成済みのローカルインタープリターまたはリモートインタープリターを選択するか、 参照ボタン をクリックして新しいインタープリターを構成することもできます。

    詳細については、「リモート Node.js ランタイムの構成」、「ローカル Node.js ランタイムの構成」、「Linux の Windows サブシステムで Node.js を使用する 」を参照してください。

    必要に応じて、Node.js に渡す Node.js 固有のオプションパラメーター環境変数(英語)を指定します。

  6. 使用するパッケージマネージャーを指定します。 Project エイリアスを選ぶと、WebStorm は JavaScript ランタイムページでプロジェクトのデフォルトパッケージマネージャーを使います。 関連するパッケージのエイリアス (npm または yarn) を選択したり、パッケージマネージャーのカスタムインストールへの明示的なパスを指定したりすることもできます。

  7. Docker コンテナーでリモート Node.js ランタイムを使用している場合は、自動生成された Docker コンテナーの設定を確認してください。 Expand アイコン をクリックすると、ポップアップで設定が開きます。

    Docker コンテナーの設定を確認する

    npm、pnpm、yarn と Dockerリモート Node.js ランタイムの設定の詳細を参照してください。

スクリプトを実行する

なんでも実行でスクリプトを実行する

なんでも実行は、スクリプトをすばやく開始する方法です。

  1. Ctrl を 2 回押すか、ナビゲーションバーの Run Anything ボタン をクリックします。 なんでも実行 ポップアップが開きます。

  2. 検索フィールドにパッケージマネージャーの名前を入力します。 入力すると、WebStorm が一致するコマンドを表示します。

    なんでも実行: パッケージマネージャーの名前を入力する

    または、スクリプトの名前を入力します。

    なんでも実行: スクリプトの名前を入力する

    最後に、 ? と入力すると、コマンドのヒントのリストが表示されます。

    なんでも実行で使用可能なコマンドのリスト

    関連するヒントに移動し、 Space を押して使用可能なコマンドのリストを取得し、リストから必要なコマンドを選択して、 Enter を押します。

    コマンド出力を 実行 ツールウィンドウに表示するには、 Ctrl+Enter を押し、出力を デバッグ ツールウィンドウに表示するには、 Shift+Enter を押します。

    Run an npm command in the Run or Debug tool window from the Run Anything popup

起動時にスクリプトを自動的に実行する

定期的に実行するスクリプトがいくつかある場合は、対応する実行構成を 起動タスクのリストに追加できます。 タスクはプロジェクトの起動時に自動的に実行されます。

  1. 設定 ダイアログ(Ctrl+Alt+S )で ツール | スタートアップタスク に移動します。

  2. 開いた 起動タスクページで、ツールバーの 追加ボタン をクリックします。

  3. リストから、必要な npm 実行構成を選択します。 設定がリストに追加されます。

    プロジェクトに適用可能な構成がない場合は、 Add ボタン` をクリックして 実行構成の編集 を選択します。 次に、開いた 実行 / デバッグ構成ページで必要な設定を使用して構成を定義します。 新しい設定を保存すると、自動的に起動タスクのリストに追加されます。

起動前のタスクとしてスクリプトを実行する

  1. メインメニューから 実行 | 実行構成の編集 を選択して 実行 / デバッグ構成ダイアログ ダイアログを開き、リストから必要な構成を選択するか、 新しい構成を追加 をクリックして関連する実行構成タイプを選択して新規に作成します。

  2. 開いたダイアログで、 起動前 エリアの 追加 をクリックし、リストから npm スクリプトを実行 を選択します。

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

デバッグスクリプト

npm、Yarn、pnpm スクリプトのデバッグは、エディター内の package.json ファイル、専用の npm ツールウィンドウ内のスクリプトツリー、または専用の実行構成に従って開始できます。

いずれの場合も、WebStorm は デバッグツールウィンドウを開き、そこで スクリプトをステップ実行したり、スクリプトの実行を 停止および再開したり、 中断中に調べたりデバッガーコンソールで JavaScript コードスニペットを実行したりできます。

package.json からのデバッグスクリプト

WebStorm を使うと、 package.json ファイルから単一スクリプトのデバッグセッションを素早く開始できます。 複数のスクリプトをデバッグするには、実行構成または npm ツールウィンドウを使用してください。

  • エディターで該当する package.json ファイルを開き、スクリプトの横にあるガター内の Run ボタン をクリックし、コンテキストメニューから デバッグ <script_name> を選択します。

    package.json からスクリプトをデバッグする

WebStorm は デバッグツールウィンドウを開き、そこで スクリプトをステップ実行したり、スクリプトの実行を 停止および再開したり、 中断中に調べたりデバッガーコンソールで JavaScript コードスニペットを実行したりできます。

npm ツールウィンドウからスクリプトをデバッグする

プロジェクト ツールウィンドウ(Alt+1 )で package.json ファイルを選択するか、エディターでファイルを開いてコンテキストメニューから npmスクリプトの表示 を選択すると、 npm ツールウィンドウが開きます。

npm、pnpm、Yarn を呼び出すとすぐに、ツールは、呼び出された package.json ファイルの scripts プロパティ内で定義されたスクリプトのツリーの構築を開始します。

プロジェクトに複数の package.json ファイルがある場合は、それらごとに個別のスクリプトツリーを構築し、以前に構築したツリーを削除せずにスクリプトを実行できます。 各ツリーは個別のノードに表示されます。

npm ツールウィンドウがまだ開いていない場合は開く

  • プロジェクト ツールウィンドウ(Alt+1 )で必要な ファイルを選択するか、エディターでファイルを開き、コンテキストメニューから npmスクリプトの表示 を選択します。

    nmp ツールウィンドウを開く

    npm ツールウィンドウが開き、選択または開いた package.json ファイルに従って作成されたスクリプトツリーが表示されます。

すでに開いている npm ツールウィンドウでスクリプトのツリーを構築する

  1. npm ツールウィンドウで、ツールバーの 追加ボタン をクリックし、リストから必要な package.json ファイルを選択します。 デフォルトで WebStorm はプロジェクトのルートの package.json ファイルを表示します。

  2. 別の package.json ファイルがある場合は、 package.json を選択する をクリックして表示されるダイアログで必要な package.json ファイルを選択します。 WebStorm は、選択した package.json ファイルのパスがタイトルになった新しいノードを追加し、その下にスクリプトのツリーを作成します。

別のスクリプトツリーを構築する

ツリーを再構築する

  • 必要なノードに切り替えて、ツールバーの スクリプトを再読み込み をクリックします。

ツリー内のスクリプトを名前でソートする

  • ツールバーの 設定 をクリックし、メニューから 並べ替え を選択してから、 名前 を選択します。

    デフォルトでは、ツリーには、 package.json (オプション 定義順序 )で定義されている順序でスクリプトが表示されます。

1 つのスクリプトをデバッグする

複数のスクリプトをデバッグする

  • 複数選択モードを使用します:隣接するアイテムの場合は Shift キーを、隣接しないアイテムの場合は Ctrl キーを押しながら、必要なスクリプトを選択し、選択のコンテキストメニューから 実行 または デバッグ を選択します。

    複数のスクリプトをデバッグする

実行構成によるデバッグスクリプト

エディターまたは npm ツールウィンドウでスクリプトの実行やデバッグを行うと、WebStorm が 一時的な実行構成を自動作成します。 使用する以外に、独自の npm 実行構成を作成して起動できます。

  1. 実行 | 実行構成の編集 に進みます。 または、ツールバーの 実行 ウィジェットから 実行構成の編集 を選択します。

    構成の編集を開くダイアログ
  2. 開いた 実行構成の編集 ダイアログで、ツールバーの 追加 ボタン (追加ボタン) をクリックし、リストから npm を選択します。 実行 / デバッグ構成: npm ダイアログが開きます。

  3. 実行する CLI コマンド、実行するスクリプト(区切り文字として空白を使用)、およびこれらのスクリプトが定義されている package.json ファイルの場所を指定します。 必要に応じて、スクリプトを実行するための コマンドライン引数(英語)を入力します。

  4. パッケージマネージャーのコマンドラインインターフェースの詳細については、 npm 公式 Web サイト(英語)および Yarn オフィシャル Web サイト(英語)を参照してください。

  5. 使用する Node.js ランタイムを指定します。

    プロジェクト エイリアスを選択した場合、WebStorm は JavaScript Runtime ページの ノードランタイム フィールドにあるプロジェクトのデフォルトインタープリターを自動的に使用します。 ほとんどの場合、WebStorm はプロジェクトのデフォルトランタイムを検出し、自動的にフィールドに入力します。

    別の構成済みのローカルインタープリターまたはリモートインタープリターを選択するか、 参照ボタン をクリックして新しいインタープリターを構成することもできます。

    詳細については、「リモート Node.js ランタイムの構成」、「ローカル Node.js ランタイムの構成」、「Linux の Windows サブシステムで Node.js を使用する 」を参照してください。

    必要に応じて、Node.js に渡す Node.js 固有のオプションパラメーター環境変数(英語)を指定します。

  6. 使用するパッケージマネージャーを指定します。 Project エイリアスを選ぶと、WebStorm は JavaScript ランタイムページでプロジェクトのデフォルトパッケージマネージャーを使います。 関連するパッケージのエイリアス (npm または yarn) を選択したり、パッケージマネージャーのカスタムインストールへの明示的なパスを指定したりすることもできます。

  7. Docker コンテナーでリモート Node.js ランタイムを使用している場合は、自動生成された Docker コンテナーの設定を確認してください。 Expand アイコン をクリックすると、ポップアップで設定が開きます。

    Docker コンテナーの設定を確認する

    Docker で npm、pnpm、yarn を使う方法および リモート Node.js ランタイムの設定の詳細をご覧ください。

  8. ツールバーの 実行 ウィジェットから、新しく作成した実行構成を選択し、その横にある デバッグ をクリックします。

    WebStorm は デバッグツールウィンドウを開き、そこで スクリプトをステップ実行したり、スクリプトの実行を 停止および再開したり、 中断中に調べたりデバッガーコンソールで JavaScript コードスニペットを実行したりできます。

npm、pnpm、Docker の yarn

WebStorm を使えば、 package.json の編集、Docker コンテナー内のプロジェクト依存関係のインストール・更新・削除をローカルと同様に行うことができます。

  1. Node.jsNode.js リモートインタープリターDockerに必要なプラグインが 設定 | プラグイン ページ・タブ インストール済み で有効になっていることを確認してください。 詳細については、 プラグイン管理を参照してください。

  2. DockerDocker の説明どおりにダウンロード、インストール、設定します。

  3. Docker で Node.js リモートランタイムを構成するまたは Docker Compose 経由でインストールし、プロジェクトの デフォルトとして設定してください。 また、このリモートランタイムに関連付けられたパッケージマネージャーが プロジェクトのデフォルトとして設定されていることを確認してください。

  4. ローカル開発と同様に、 package.json を編集プロジェクト依存関係を管理スクリプトを実行またはデバッグしてください。

2026 年 6 月 8 日