WebStorm 2026.1 Help

中断されたプログラムを調べる

デバッガーセッションが 開始されると、 デバッグツールウィンドウが表示され、 ブレークポイントに到達するか、プログラムを手動で一時 停止するまで、プログラムは正常に実行されます。

その後、プログラムは中断され、現在の状態を調べたり、実行を制御したり、実行時にさまざまなシナリオをテストしたりできます。

コールスタックを調べる

プログラムが一時停止されると、 この時点に到達したコールスタック(英語)フレーム ペインに表示されます。

フレームタブ

マルチプロセス Node.js アプリケーションまたはサービスワーカーをデバッグしているときに、スレッドを切り替えることができます。 フレーム ペインには、選択したスレッドの呼び出しスタックが表示されます。 マルチプロセスデバッグ および ワーカーのデバッグから詳細を参照してください。

スレッド間の切り替え

他の場合では、スレッドが 1 つしかない場合でも、 フレーム ペインの スレッド フィールドに メインスレッド が表示されます。

シングルスレッドアプリケーションのメインスレッドが表示されます

フレームはアクティブなメソッドまたは関数呼び出しに対応します。 呼び出されたメソッドまたは関数のローカル変数、その引数、式の評価を可能にするコードコンテキストを格納します。

method が呼び出されるたびに、新しいフレームがスタックの一番上に追加されます。 method の実行が完了すると、対応するフレームがスタックから削除されます(後入れ先出し方式)。

フレームを調べると、特定のパラメーターがメソッドまたは関数に渡された理由と、呼び出し時の呼び出し元の状態を理解できます。

デフォルトでは、WebStorm はフレームワークとライブラリの呼び出しに対応するフレームを非表示にします。

ライブラリからフレームを表示

  1. 非表示のフレームを表示するには、 フレーム ペインの右上隅にある すべてのフレームを表示 トグルボタン ライブラリのフレームを表示ボタン を押します。

  2. ライブラリフレームを非表示にするには、 フレームをライブラリから非表示 トグルボタン Hide Frames from Libraries button を放します。

    ライブラリフレームが非表示になっている場合は、「すべてのフレームを表示」ボタンを切り替える
    ライブラリフレームが表示されたら、ライブラリのフレームを非表示ボタンを切り替える

スタックをクリップボードにコピー

  • 現在のスレッドのコールスタックをコピーするには、 フレーム タブの任意の場所を右クリックして、 スタックをコピー を選択します。

変数の調査 / 更新

変数 タブには、選択した フレーム / スレッド内の変数のリストが表示されます。 変数を調べると、プログラムが特定の方法で動作する理由を理解できます。

変数タブには、現在の実行ポイントから見える変数が表示されます

各変数の左側のアイコンは、その型を示しています。

変数のコピー

変数を調べるときに、変数名または値をコピーして別の場所に貼り付けたり、別の変数と 比較したりする必要がある場合があります。

  • 変数の名前をコピーするには、変数を右クリックして 名前をコピー を選択します。

  • 変数が保持する値をコピーするには、変数を右クリックして 値をコピー Ctrl+C を選択します。 String 以外の型の場合、 toString 表現がコピーされます。

変数をクリップボードと比較する

変数値を他の値と比較するには、 クリップボードと値を比較 オプションを使用します。 これは、たとえば、変数に長い文字列が格納されていて、それを別の長い文字列と比較する必要がある場合に役立ちます。

  1. たとえば、テキストファイルから比較するコンテンツをコピーします。

  2. 変数 タブで変数を右クリックし、 クリップボードと値を比較 を選択します。

  3. 開いた差分ビューアーで相違点を調べます。 差分ビューアー の詳細については、 ファイルとフォルダーの比較を参照してください。

専用の変数を表示するダイアログ

WebStorm では、専用のダイアログで変数をインスペクションできます。 これは、変数(または参照が保持されているオブジェクト)を追跡し、同時にフレームとスレッド間を移動できるようにする必要がある場合に便利です。

  • 変数またはウォッチを右クリックし、 インスペクション を選択します。

    インスペクションダイアログ

変数値を設定

プログラムが特定のデータに対してどのように動作するかをテストしたり、実行時にフローを変更したりする場合は、変数値を変更することでそれを実現できます。

  1. 変数を選択し、 F2 を押します。 または、コンテキストメニューから 値を設定 を選択します。

  2. 変数の値を入力し、 Enter を押します。

    名前の横にあるフィールドに変数の新しい値を入力する

instance="rm"/;

変数 ペインから宣言に移動できます。

  • 変数が宣言されているコードに移動するには、変数を右クリックして ソースに移動 F4 を選択します。

  • 変数型のクラス宣言に移動するには、変数を右クリックして 型ソースに移動 Shift+F4 を選択します。

変数ビューで getter 関数と setter 関数を表示

デフォルトでは、 getter および setter 関数は非表示になっています。

Getter と Setter をオフに表示
  • これらを 変数 ビューに表示するには、ツールバーの the More アイコン をクリックし、 デバッガー設定 を選択してから、 Getter と Setter の機能を表示 を選択します。

    Getter と Setter を表示する

式の評価

WebStorm を使用すると、デバッグセッション中に式を評価して、プログラムの状態に関する追加の詳細を取得したり、実行時にさまざまな実行シナリオをテストしたりできます。

この機能は、プログラムがブレークポイントに到達した後に中断された(一時停止されていない)場合にのみ機能します。

式内で呼び出されるメソッド内にブレークポイントがある場合、それらは無視されます。

エディターで簡単な式を評価する

式をすばやく評価するには、エディターで式をポイントします。 メソッド呼び出しはこの方法では評価できないことに注意してください。

  1. 評価する式をポイントします。 式の結果がツールチップに表示されます。

    値のツールチップ
  2. 子要素を表示するには、をクリックします。

    子グループを持つ値ツールチップ

値のツールチップが邪魔になる場合は、遅延を増やすか、完全に無効にすることができます。 これを行うには、 設定 ダイアログ (Ctrl+Alt+S) で ビルド、実行、デプロイ | デバッガー | データビュー に移動し、好みに応じて 値ツールチップを表示 および 値ツールチップの遅延 オプションを設定します。

エディターで複雑な式を評価する

メソッド呼び出しを含むコード内の式を評価する場合、または評価する式の特定の部分を指定する場合は、 式のクイック評価 オプションを使用します。

  • 式を選択して、 Ctrl+Alt+F8 を押すか、表示されるフローティングツールバーの the Quick Evaluate Expression icon をクリックします。

    値のツールチップが表示されます
  • あるいは、 実行 | デバッグアクション | 式のクイック評価 に移動するか、 Alt を押したまま選択範囲をクリックします。

  • フローティングツールバーにデバッグアクションを追加するには、 the More アイコン をクリックし、 ツールバーのカスタマイズ を選択し、開いたダイアログで 追加 をクリックして、必要なアクションを選択します。

    フローティングツールバーをカスタマイズする

式のクイック評価 を構成して、コードを選択するだけで(メニュー / ショートカットを使用せずに)コードで機能するようにできます。 このオプションを有効にすると、誤ってメソッドを呼び出す可能性があるため、慎重に使用してください。

コード選択時に式を評価する

  • 設定 | ビルド、実行、デプロイ | デバッガー | データビュー に移動し、 コード選択時に値ツールチップを表示する オプションを設定します。

任意の式を評価する

任意の式を評価することは、最も柔軟な評価オプションです。 現在のフレームのコンテキスト内にある限り、任意のカスタムコードを評価できます。 これを使用すると、宣言、メソッド呼び出し、匿名クラス、アロー関数、ループなどを評価できます。

  1. 任意の式を評価するには、 変数 ペインの 式の評価 フィールドに式を入力し、 Enter を押します

    変数タブの式
  2. 結果はすぐ下に表示されます。 式フィールドの右側にある をクリックして、 式をウォッチに追加することもできます。

    変数タブの式の結果

長いコードブロックを評価したい場合は、そのための専用ダイアログを利用すると良いでしょう:

  1. 現在目の前にある式または変数 (たとえば、エディターまたは 変数 ペイン) から開始する場合は、それを選択します。

  2. 実行 | デバッグアクション | 式の評価 Alt+F8 に移動するか、コンテキストメニューから 式の評価 を選択します。 ショートカットは Ubuntu では機能しない可能性があります (正しく操作するには、 ショートカット設定を調整してください)。

    開始する式を選択する
  3. 評価 」ダイアログで、選択した式を変更するか、「 」フィールドに新しい式を入力します。 複数行のコードフラグメントを変更するには、「展開 Shift+Enter 」をクリックします。

    式はコードフラグメントフィールドに入力されます: フィールドサイズの調整
  4. 評価 (複数行モードの場合は Ctrl+Enter )をクリックします。 式の結果が 結果 フィールドに表示されます。

    式の結果は、return ステートメントから取得されます。 return ステートメントがない場合、結果はコードの最後の行から取得されます(式である必要はなく、単一のリテラルでもかまいません)。 値を取得するための有効な行がない場合、結果は undefined です。 指定した式が評価できない場合、 結果 フィールドに理由が表示されます。

    式の結果が計算されます

評価 ダイアログは非モーダルなので、フォーカスをエディターに戻して他の変数や式をコピーすることができます。 また、複数の 評価 ダイアログを開くこともできます。

インラインで値を表示

WebStorm は、変数の使用箇所のすぐ隣に変数の値を表示します。

変数値は、使用される行に表示されます

変数値が変更されると、インラインビューが新しい値で更新され、色が変更されます。

変数のインライン値は各ステップで変化する

行にオブジェクトへの参照が含まれている場合は、エディターでそのフィールドを直接調べることができます。 このポップアップから、 変数値を変更インラインウォッチを追加することもできます。

インラインデバッガーのヒント

インラインビューはデフォルトで有効になっています。 これをオフにするには、 設定 ダイアログ (Ctrl+Alt+S) で ビルド、実行、デプロイ | デバッガー | データビュー に移動し、 値をインラインで表示する オプションを無効にします。

インラインウォッチを追加する

ある式の結果を特定の行に表示したい場合は、そのためのインライン ウォッチを設定できます。 インラインウォッチは永続的であり、セッションの再開後もアクティブなままです。

  1. フィールドを追跡するオブジェクトを参照するインラインヒントをクリックします。

  2. ポップアップで、フィールドを選択し、 インラインウォッチとして追加 をクリックします。

    インラインウォッチオプションの追加
  3. 必要に応じてウォッチを微調整します。 有効な式をウォッチとして使用できます。

    インラインウォッチの設定

エディターで設定したインラインウォッチは、 デバッグ ツールウィンドウの変数ペインの インラインウォッチ にも表示されます。

デバッグツールウィンドウのインラインウォッチ

インラインウォッチを削除するには、ウォッチにカーソルを合わせ、近くの十字をクリックします。

JSON と XML を視覚化する

インライン値を展開したり、JSON または XML を含む 文字列式を評価したりすると、WebStorm によってデータの構造化されフォーマットされたビューが提供されます。

これにより、 コードの折りたたみ選択範囲の拡大または縮小などのエディター機能を使用して、サブツリーを操作したり、大きなオブジェクト内での便利なナビゲーションを行ったりすることができます。

プレビューポップアップのタブを使用して、構造化ビューと生のビューを切り替えます。

%alt

ウォッチ式

変数またはより複雑な式の結果を追跡したい場合は、この変数または式の監視を設定します。 これは、変数のリストに定期的に表示されないものを評価する必要がある場合や、インスタンス変数を固定する必要がある場合に便利で、各 ステップの後にツリーを展開する必要がなくなります。

この機能は、プログラムがブレークポイントに到達した後に中断された(一時停止されていない)場合にのみ機能します。

ウォッチは、選択したフレームのコンテキストで評価されます。 ウォッチは、コンテキストから外れている場合、またはコンパイルに失敗した場合は評価できません。 この場合、ウォッチにはエラーアイコン エラーアイコン のマークが付けられます。

デフォルトでは、監視は変数とともに 変数 ペインに表示されます。 ウォッチ式 ペインを表示 / 非表示にするには、 レイアウト設定 「レイアウトを復元」ボタン メニューの ウォッチを個別に表示 オプションを使用します。

ウォッチを追加する

追跡したい式に応じて:

  • エディター内の式の場合 – 式を選択し、表示されるフローティングツールバーの ウォッチに追加 アイコン( )をクリックします。 または、式を 変数 タブにドラッグします。

    フローティングツールバーのウォッチに追加ボタン
  • 現在のコンテキスト内の要素の場合 – 変数 タブで変数を右クリックし、メニューから ウォッチに追加 を選択します。

    現在のコンテキストからウォッチを追加する
  • 任意の式の場合 – 変数 タブの上部に式を入力し、 ウォッチに追加 をクリックします。

    監視式

    ウォッチ式 に変数 / 式を追加した後、変数 / 式はそこに残り、各 ステップで評価され、現在のコンテキストで結果を提供します。

    ウォッチの評価結果

ウォッチを編集する

  • 目的のウォッチを右クリックして、 編集 を選択します。

ウォッチをコピーする

  1. コピーしたいウォッチを選択します。

  2. 変数 ペインで ウォッチ式の複製 Duplicate Watch button をクリックするか、 Ctrl+D を押します。

ウォッチの順序を変更する

便宜上、 変数/ウォッチ式 ペインに表示されるウォッチの順序を変更できます。

  • 変数/ウォッチ式 ペインの ウォッチ式を上に移動/ウォッチ式を下に移動 ボタン、または Ctrl+Up および Ctrl+Down キーボードショートカットを使用します。

ウォッチを削除する

  • 単一の監視を削除するには、それを右クリックして ウォッチ式を除去 を選択します。 または、ウォッチを選択し、 変数/ウォッチ式 ペインで Delete を押します。

  • すべての監視を削除するには、 変数/ウォッチ式 ペインの任意の場所を右クリックし、 すべてのウォッチ式を除去 を選択します。

ウォッチは、変数と同じアクションを可能にします。 例: 専用のダイアログで表示したりソースコードに移動したりするために使用できます。

ウォッチはプロジェクトの一部です。 これは、デバッグセッションを失うリスクなしに、デバッグセッションを停止して再実行できることを意味します。

視聴を一時停止して再開する

ウォッチがローカルコンテキストに依存していたり、大量の計算を伴う場合、一部のステップでは評価が現実的でないことがあります。 そのような場合は、ウォッチを一時停止して必要に応じて評価することができます。

  • ウォッチを一時停止するには、ウォッチを右クリックし、 ウォッチを一時停止 を選択します。

    ウォッチを一時停止する
  • ウォッチを再開するには、ウォッチを右クリックし、 ウォッチを再開 を選択します。

    一時停止した視聴を再開する
  • 一時停止中のウォッチの 1 回限りの評価を実行するには、ウォッチの近くにある 評価 をクリックします。

    一時停止したウォッチを評価する

実行ポイント

現在の実行ポイントに戻る

プログラムの状態を調べるには、コード内を移動する必要があり、多くの場合、プログラムが中断されている場所に戻る必要があります。

次のいずれかを実行します:

  • メインメニューで 実行 | デバッグアクション | 実行ポイントの表示 へ移動します。

  • Alt+F10 を押す。

  • デバッグ ツールウィンドウのステップツールバーで More ボタン をクリックし、開いたコンテキストメニューから 実行箇所を表示ボタン実行ポイントの表示 を選択します。

    実行ポイントオプションを表示

現在の実行ポイントは青い線で示されます。 この行のコードはまだ実行されていません。

現在の実行ポイントを示す青い線
2026 年 6 月 8 日