WebStorm 2026.3 Help

Angular アプリケーションの実行とデバッグ

始める前に

  1. コンピューターに Node.js(英語) があることを確認してください。

  2. Angular と AngularJS と JavaScript デバッガー の必須プラグインが 設定 | プラグイン ページで有効になっていることを確認してください。 詳細については、 プラグインの管理を参照してください。

Angular アプリケーションを実行する

  1. 実行アイコン を package.json 内の start スクリプトの横にあるガターでクリックするか、 ターミナル Alt+F12 で npm run start コマンドを実行するか、 npm ツールウィンドウ (表示 | ツールウィンドウ | npm) で start タスクをダブルクリックします。

    Run an Angular app in the development mode from package.json
  2. アプリケーションのコンパイルと開発サーバーの準備が完了するまでお待ちください。

    実行 ツールウィンドウまたは ターミナル には、アプリケーションが実行されている URL が表示されます。 アプリケーションが @angular/cli で生成された場合、デフォルトの URL は http://localhost:4200/ です。 このリンクをクリックすると、アプリケーションが表示されます。

    Angular CLI アプリを実行する: 開発サーバーの準備ができました

実行 / デバッグ構成を介して Angular アプリケーションを実行する

Angular CLI で WebStorm 新規プロジェクト ウィザードを使ってアプリケーションを作成した場合、 上記のように 、WebStorm はデフォルト名 Angular CLI サーバー の npm 構成を生成します。 この構成は、開発サーバーを起動し、開発モードでアプリケーションを起動する ng serve コマンドを実行します。

それ以外の場合は、ホスト、ポートなどの実際の設定を手動で 実行 / デバッグ構成を作成するする必要があります。

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

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

    構成の編集を開くダイアログ

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

  2. 開いた 実行 / デバッグ構成:npm ダイアログの 構成 タブで、 package.json の場所、Node.js ランタイム、および使用するパッケージマネージャーを指定します。

    コマンド フィールドで、リストから 実行 を選択し、次に スクリプト リストから実行するスクリプトを選択します。 ほとんどの場合、デフォルトの start スクリプトになりますが、カスタムポートでアプリケーションを実行するなど、 package.json で別のスクリプトを構成することもできます。

    npm 実行 / デバッグ構成
  3. オプション:

    ブラウザーでアプリケーションを開くには、構成を次のように更新します: ブラウザー / Live Edit タブで、 起動後 チェックボックスをオンにし、アプリケーションを開くブラウザーを選択して、アプリケーションが実行される URL アドレスを指定します。

    アプリケーションをデバッグする場合は、 Google Chrome(英語) または別の Chromium ベースのブラウザー(英語)を選択します。

    ブラウザー / ライブ編集タブ: ブラウザーを選択

アプリケーションの実行

  1. ツールバーの 実行 ウィジェットのリストから、 すでに npm タイプの実行構成を選択します。 これは、自動生成された Angular CLI サーバー 構成、または 上記のように自分で作成したカスタム構成にすることができます。

  2. 実行 をクリックしてください。

    実行 / デバッグ構成を介して開発モードで Angular アプリを実行する
  3. アプリケーションのコンパイルと開発サーバーの準備が完了するまでお待ちください。

    実行 ツールウィンドウまたは ターミナル には、アプリケーションが実行されている URL が表示されます。 アプリケーションが @angular/cli で生成された場合、デフォルトの URL は http://localhost:4200/ です。 このリンクをクリックすると、アプリケーションが表示されます。

    Angular CLI アプリを実行する: 開発サーバーの準備ができました

    または、 上記のように、WebStorm で起動時にアプリケーションを開くよう有効にできます。

Angular アプリケーションをデバッグする

デバッグセッションは、 実行 / デバッグ構成を起動するから開始することも、開発モードでアプリケーションが実行されている URL を表示する 実行ツールウィンドウから開始することもできます。

実行 / デバッグ構成を介してデバッグを開始する

Angular アプリケーションをデバッグするには、次の 2 つの実行 / デバッグ構成が必要です。

  • 上記のように、開発モードでアプリケーションを起動するための すでに npm 構成。

  • 開発モードで実行されているアプリケーションにデバッガーを接続するための JavaScript Debug 構成。

npm 実行 / デバッグ構成を使用して Angular アプリケーションを実行およびデバッグするに従って、 すでに npm 構成内に JavaScript Debug 構成を作成して、一度に起動することができます。

または、 すでに npm および JavaScript Debug 実行/デバッグ構成を、 JavaScript デバッグ実行/デバッグ構成でデバッグを開始に従い、個別に起動します。

単一の npm 実行 / デバッグ構成で Angular アプリケーションを実行およびデバッグする

  1. コードに ブレークポイントを設定します。

  2. 上記の説明に従ってすでに npm 構成を作成します。

  3. 開いた 実行 / デバッグ構成:npm ダイアログの 構成 タブで、 package.json の場所、Node.js ランタイム、および使用するパッケージマネージャーを指定します。

    コマンド フィールドで、リストから 実行 を選択し、次に スクリプト リストから実行するスクリプトを選択します。 ほとんどの場合、デフォルトの start スクリプトになりますが、カスタムポートでアプリケーションを実行するなど、 package.json で別のスクリプトを構成することもできます。

    npm 実行 / デバッグ構成
  4. ブラウザー / Live Edit タブで、 起動後 チェックボックスを選択し、リストから Google Chrome(英語) または別の Chromium ベースのブラウザー(英語)を選択し、 JavaScript デバッガーを使用して チェックボックスを選択して、アプリケーションを実行する URL を指定します。

    ブラウザー / ライブ編集タブ: ブラウザーを選択
  5. 実行 をクリックしてください。

    構成を再実行するには、 実行 ウィジェットのリストから構成を選択し、その横にある 実行 をクリックします。

    WebStorm はアプリケーションを開発モードで実行し、同時にデバッグセッションを開始します。

    デバッグセッション
  6. 最初のブレークポイントに到達したら、 デバッグツールウィンドウ に切り替え、通常どおり続行します: プログラムをステップ実行し、 プログラムの実行を停止して再開し、 中断時にそれを調べ 、コールスタックと変数を調べ、ウォッチを設定し、変数を評価し、 実際のHTML DOMを表示します。

    ソースマップを無視して実際に実行されるコードをステップ実行するには、 ソースマップ無効化トグルボタン を デバッグ ツールウィンドウのツールバーで押してください。 詳細については、 ソースマップを無効化 を参照してください。

JavaScript デバッグ実行 / デバッグ構成でデバッグを開始する

  1. コードに ブレークポイントを設定します。

  2. 上記のように開発モードでアプリケーションを起動し、アプリケーションがコンパイルされて開発サーバーの準備ができるまで待ちます。

    実行 ツールウィンドウまたは ターミナル には、アプリケーションが実行されている URL が表示されます。 この URL をコピーして、 後で JavaScript デバッグ構成で指定します。

    Angular アプリは開発モードで実行されています
  3. JavaScript Debug 構成を作成します。 これを行うには、メインメニューの 実行 | 実行構成の編集 に移動し、 追加アイコン をクリックして、リストから JavaScript Debug を選択します。

    上記のように Angular CLI を使用してアプリケーションを生成した場合、WebStorm は、デフォルト名 アプリケーションのデバッグ​​/ とデフォルト URL http://localhost:4200 を持つ JavaScript Debug 実行 / デバッグ構成をすでに作成しています。 JavaScript Debug ノードのリストからこの実行 / デバッグ構成を選択します。

    生成された JavaScript デバッグ実行 / デバッグ構成を選択する
  4. 開いた 実行 / デバッグ構成:JavaScript デバッグ ダイアログで、構成の名前と、開発モードでアプリケーションが実行されている URL アドレスを指定します。 この URL は、 実行 ツールウィンドウまたは ターミナル で、 上記のようにコピーできます。

    JavaScript デバッグ構成を作成する: URL を指定する
  5. デバッグ をクリックしてください。

    構成を再実行するには、 実行 ウィジェットのリストから構成を選択し、その横にある デバッグ をクリックします。

    実行ウィジェットから JavaScript デバッグ構成を実行する
  6. 最初のブレークポイントに到達したら、 デバッグツールウィンドウ に切り替え、通常どおり続行します: プログラムをステップ実行し、 プログラムの実行を停止して再開し、 中断時にそれを調べ 、コールスタックと変数を調べ、ウォッチを設定し、変数を評価し、 実際のHTML DOMを表示します。

    ソースマップを無視して実際に実行されるコードをステップ実行するには、 ソースマップ無効化トグルボタン を デバッグ ツールウィンドウのツールバーで押してください。 詳細については、 ソースマップを無効化 を参照してください。

実行ツールウィンドウまたは組み込みのターミナルからデバッグを開始する

アプリケーションが localhost の開発モードで実行されている場合、特に Angular CLI を使用して生成された場合は、 > 実行 ツールウィンドウまたは組み込みの ターミナル から直接デバッグセッションを開始できます。

  1. コードに ブレークポイントを設定します。

  2. 上記のように開発モードでアプリケーションを起動し、アプリケーションがコンパイルされて開発サーバーの準備ができるまで待ちます。

  3. 実行 ツールウィンドウまたは ターミナル には、アプリケーションが実行されている URL が表示されます。 アプリケーションが @angular/cli で生成された場合、デフォルトの URL は http://localhost:4200/ です。 Ctrl+Shift を押したまま、この URL リンクをクリックします。 WebStorm は、タイプ JavaScript デバッグ の自動生成された Angular アプリケーション 構成でデバッグセッションを開始します。

    Starting a debugging session from the Run tool window

    あるいは、リストから自動生成された Angular アプリケーション 構成を選択し、リストの横にある デバッグ ボタン 「デバッグ」ボタン をクリックします。

    新しいターミナルから開発モードでアプリケーションを起動している場合は、リンクの横の ブラウザーでデバッグを開始する ボタンをクリックするだけです。

    新しいターミナル: ブラウザーで Angular のデバッグを開始するボタン

    デフォルトでは、このボタンは表示されません。 表示するには、 設定 ダイアログ(Ctrl+Alt+S )を開き、 詳細設定 に移動して、 JavaScript と TypeScript エリアの ターミナルの localhost リンクに「ブラウザでデバッグを開始」ボタンを表示する チェックボックスを選択してください。

最初のブレークポイントに到達したら、 デバッグツールウィンドウに切り替え、通常どおり続行します: プログラムをステップ実行し、 プログラムの実行を停止して再開し、 中断時にそれを調べ 、コールスタックや変数を確認し、ウォッチを設定して変数を評価し、 実際の HTML DOM を表示するなど、操作できます。

ソースマップを無視して実際に実行されるコードをステップ実行するには、 ソースマップ無効化トグルボタン を デバッグ ツールウィンドウのツールバーで押してください。 詳細については、 ソースマップを無効化 を参照してください。

Node.js 17 以降のトラブルシューティング

Node.js バージョン 17 以降を使用している場合、デバッグセッション中にネットワーク接続の問題が生じ、デバッガーの接続やソースマップの読み込みに不具合が発生する場合があります。

回避策は、 package.json の start スクリプトを次のように更新して、 --host 127.0.0.1 をサーバーに渡すことです。

"start": "ng serve --host=127.0.0.1"
2026 年 11 月 6 日