WebStorm 2026.3 Help

JavaScript デバッガーの構成

WebStorm は、 client-side JavaScript コード用の組み込みデバッガーを提供します。 デバッグセッションを開始すると、ビルトインデバッガーが自動的に起動します。

デバッグを正常に行うには、組み込みの Web サーバーポートを指定し、他のデバッガーオプションについては WebStorm が提案するデフォルト設定を受け入れるだけで十分です。

始める前に

  • 設定で JavaScript Debugger バンドルプラグインが有効になっていることを確認します。 Ctrl+Alt+S を押して設定を開き、 プラグイン を選択します。 検索フィールドに JavaScript Debugger と入力します。 プラグインに関する詳細は、 プラグインの管理を参照してください。

組み込みの Web サーバーポートを設定する

WebStorm には組み込みの Web サーバーがあり、Web ブラウザーでアプリケーションのデバッグや WebStorm の組み込みブラウザーでコードのプレビューができます。 このサーバーは常に実行されており、手動による構成は必要ありません。 組み込みサーバーで実行されているアプリケーションをデバッグする詳細を参照してください。

  1. Ctrl+Alt+S を押して設定を開き、 ツール | ウェブブラウザーとプレビュー を選択します。

  2. ビルトインサーバー エリアで、組み込み Web サーバーが実行されるポートを指定します。 デフォルトでは、このポートは WebStorm がサービスからの接続を受け付けるデフォルトの WebStorm ポート 63342 に設定されています。 ポート番号は 1024 から始まる他の値に設定できます。

    内蔵サーバーポート​​​​​​​​​​​​​​​​​​​​​​㊀㊁㊂㊃㊄㊅㊆㊇㊈㊉㊊㊋㊌㊍㊎㊏㊐㊑㊒

デフォルトのデバッガー構成をカスタマイズする

呼び出しを抑制する

  1. Ctrl+Alt+S を押して設定を開き、 ツール | ウェブブラウザーとプレビュー に移動します。

  2. 外部接続を許可できる もしくは 署名されていない要求を許可する のチェックボックスをオフにすることで、それぞれ他のコンピューターや WebStorm の外部から組み込みサーバー上のファイルへの呼び出しを抑制できます。

    外部からの呼び出しを抑制する

ブレークポイントを削除する方法を選択する

デフォルトでは、マウスの左ボタンをクリックすることでブレークポイントを切り替えることができます。 この動作を変更するには、以下の手順に従います。

  1. Ctrl+Alt+S を押して設定を開き、 ビルド、実行、デプロイ | デバッガー に移動します。

  2. ブレークポイントの除去 領域で、適切なオプションを選択します。

    ブレークポイントを除去する

スキップするスクリプトを指定する

一部のスクリプトは、通常はデバッグする必要がないため、 ステップイン によってスキップされます。 このリストは、 ステップ実行中 タブで微調整できます。このタブは、 デバッグセッションを起動する実行/デバッグ構成にあります。 エディターからデバッグセッションを開始する場合、対応する 実行/デバッグ構成テンプレートのデフォルト設定が使用されます。

  1. デバッグセッションの起動に使用する実行/デバッグ構成を開き、 ステップ実行中 タブに切り替えます。

  2. 自動 スマートステップイン を抑制するには、 常にスマートステップインする チェックボックスをオフにします。

  3. ソースマップの ignoreList フィールドからスクリプトをスキップするには、 ソースマップで指定された既知のサードパーティスクリプトを無視する チェックボックスを選択します。

    古い Chrome 固有のフィールド名 x_google_ignoreList は非推奨ですが、 ignoreList フィールドがない場合は引き続き認識されることがあります。 詳しくは ソースマップ仕様を参照してください。

  4. カスタムスクリプトへのステップインを抑制するには、 以下のパターンに一致する URL を持つスクリプトにステップインしない チェックボックスを選択し、下の該当スクリプトのデフォルトリストを展開します。 *、 ?、 **、 ! を使用します。

    JavaScript デバッガー: スクリプトをスキップ

パターン構文

パターンでは次の文字がサポートされています:

  • アスタリスク * は、スラッシュ / 以外の任意の数の文字と一致します。 この文字は、単一のパス部分内で使用します。

  • 疑問符 ? は、スラッシュ / 以外の単一の文字と正確に一致します。

  • 二重アスタリスク ** は、セグメント全体として、任意の数のパスセグメントと一致します。 その意味は位置によって異なります:

    • 先頭部分として使用すると、任意の先頭シンボルと一致します。

    • 末尾部分として使用すると、任意の末尾シンボルと一致します。

    • 途中にある場合は、一つ以上の部分と一致します。 たとえば、 a/**/b は a/x/b および a/x/y/b と一致しますが、 a/b とは一致しません。

  • 末尾の二重アスタリスク ** が最後のセグメントの末尾にある場合(それ自体が完全なセグメントではない場合、たとえば foo** )、そのセグメントの後の任意のサフィックスと一致します。 たとえば、 foo** は foo、 foobar、 foo/bar と一致します。

  • 感嘆符 ! で始まるパターンは、指定されたパターンを否定し、リスト内でそれより前に追加されたパターンを変更します。 それ自体の新しいパターンは追加されません。

例 1

パターンリスト ["**/*.ts", "!**/*.test.ts"] では、最初の glob がすべての .ts ファイルと一致します。 二番目のパターンは、最初の glob を変更して、すべての .test.ts ファイルを一致対象から除外します。

例 2

渡された URL は、スラッシュ / によって部分に分割されます。 したがって、 **/node_modules/** は次のように分割されます::

  1. 二重アスタリスク ** は、 node_modules セグメントより前の任意のパスと一致します。

  2. node_modules は URL 内の node_modules と照合されます。

  3. 二重アスタリスク ** は、後続のすべてに一致します。

その結果、パターン **/node_modules/** は node_modules を含む任意の URL と一致します。

スクリプトの URL はパターン全体に対して照合されることに注意してください。 二番目の二重アスタリスク ** を削除すると、パターンは node_modules で終わる任意の URL と一致しますが、そのような URL はおそらく存在しません。

例 3

特定のファイル名で終わる任意のパターンと照合するには、二番目の二重アスタリスク ** を省略します。

  • **/app.js は app.js で終わるすべての URL と一致します。

  • 次のパターンリストは、 node_modules 内の app.js という名前のものを除くすべてのスクリプトを無視します。

    **/node_modules/** !**/app.js

拡張オプション

  • Ctrl+Alt+S を押して設定を開き、 ビルド、実行、デプロイ | デバッガー | データビュー に移動します。

    インラインデバッグを有効または無効にしたり、オブジェクトの値や 式の評価結果を含むツールヒントをいつ表示するかを指定したりします。

    JavaScript デバッガー: データビュー
  • Ctrl+Alt+S を押して設定を開き、 ビルド、実行、デプロイ | デバッガー | データビュー に移動します。

    オブジェクトプロパティをオブジェクトノードに表示するかどうかを指定します。 表示する場合は、プロパティを指定します。 プロパティのリストを管理するには、 と を使用します。

    オブジェクトノードに表示するプロパティ

推奨する Chrome ユーザーデータでデバッグセッションを開始する

デバッグセッションが、通常のウィンドウではなく、カスタム Chrome ユーザーデータ(英語)で新しいウィンドウで開始されることに気付くかもしれません。 その結果、ウィンドウの見た目が通常と異なり、たとえばブックマーク、ブラウザー履歴、拡張機能が表示されず、開発エクスペリエンスが損なわれます。 これは、WebStorm が Chrome デバッグプロトコル を使用し、Chrome を --remote-debugging-port オプションで実行するために起こります。 ただし、Chrome がすでに起動している場合、同じユーザーデータディレクトリを持つ新規または既存の Chrome インスタンスに対してデバッグポートを開くことができません。 そのため、WebStorm は常にカスタムユーザーデータディレクトリを持つ新しいウィンドウでデバッグセッションを開始します。

使い慣れたルックアンドフィールで新しい Chrome インスタンスを開くには、WebStorm で Chrome をユーザーデータディレクトリから開始するよう構成してください。

Custom Chrome user data

WebStorm で Chrome を設定して、推奨する Chrome ユーザーデータで起動する

  1. お好みの Chrome ユーザーデータ(英語)を Chrome のデフォルトのユーザーデータディレクトリ(英語)とは異なる別のカスタムディレクトリ 形式でコンピューターに保存します。

    Chrome 136 以降はデフォルトのユーザーディレクトリでのデバッグをサポートしていないため、お好みのユーザーデータを別のカスタムディレクトリに保存する必要があります。 詳しくは Chrome オフィシャル Web サイト(英語)を参照してください。

  2. Ctrl+Alt+S を押して設定を開き、 ツール | ウェブブラウザーとプレビュー を選択します。

  3. 新しい Chrome 構成を作成するには、 追加 をクリックします。 新しい項目がリストに表示されます。 パス フィールドに、Chrome インストールフォルダーへのパスを指定します。

  4. 新しい構成を選択し、 編集 ボタン (編集) をクリックします。

  5. Chrome 設定 ダイアログで、 カスタムユーザーデータディレクトリを使用する チェックボックスを選択し、優先するユーザーデータを含むカスタムディレクトリへのパスを指定します。

    複数の ユーザーデータプロファイル(英語)がある場合、それぞれが別々のサブディレクトリに保存されます。 プロファイルを使用するには、 コマンドラインオプション​​ フィールドで以下のように指定します。

    --profile-directory="<profile_to_use>"
    カスタムプロファイルサブディレクトリを指定する
  6. デフォルトの WebStorm ブラウザーの選択に従って、Chrome ブラウザー構成の デフォルト をマークしてください。 ブラウザー リストから必要なブラウザーを、 実行 / デバッグ構成を作成する際に必ず選択してください。

2026 年 11 月 6 日