WebStorm 2025.1 ヘルプ

TypeScript の実行とデバッグ

WebStorm を使用すると、Node.js で実行されるサーバー側 TypeScript コードと、ブラウザーで実行されるクライアント側 TypeScript コードの両方を実行およびデバッグできます。

サーバー側 TypeScript の実行とデバッグ

WebStorm を使用すると、事前に JavaScript にコンパイルしなくても、サーバー側の TypeScript コードを実行してデバッグできます。

サーバー側の複数の TypeScript ファイルアプリケーションの実行とデバッグには、WebStorm は組み込みのローダーを使用します。単一のファイルを実行またはデバッグする場合は、実行 / デバッグ構成の TypeScript ローダーリストからなしを選択してローダーをオフにすることができます。

始める前に

  1. コンピューターに Node.js(英語) 18 以上がインストールされていることを確認してください。

  2. 設定で Node.js プラグインが有効になっていることを確認します。Ctrl+Alt+S を押して設定を開き、プラグインを選択します。インストール済みタブをクリックします。検索フィールドに Node.js と入力します。プラグインの詳細については、プラグインのマッピングを参照してください。

サーバー側の TypeScript コードを実行する

サーバー側の TypeScript は、プロジェクトツールウィンドウ Alt+1、エディター、実行ウィジェットから実行できます。

  • プロジェクトツールウィンドウ Alt+1 で、実行する TypeScript ファイルまたはアプリケーションの開始ファイルを右クリックし、コンテキストメニューから <TypeScript ファイル名> を実行しますを選択します。

Run server-side TypeScript from the Project tool window
  • エディターで、実行する TypeScript ファイルまたはアプリケーションの開始ファイルを開き、リストから <TypeScript ファイル名> を実行しますを選択します。

Run server-side TypeScript from the editor
  • エディターで、実行する TypeScript ファイルまたはアプリケーションの開始ファイルを開きます。次に、ツールバーの実行ウィジェットから現在のファイルを選択し、その横にある the Run icon をクリックします。

    または、実行ウィジェットから以前に作成した実行 / デバッグ構成を選択し、その横にある the Run icon をクリックします。

Run server-side TypeScript from the Run widget

TypeScript スクラッチファイルを実行する

スクラッチファイルを実行するには、上記の方法の他に、ガターの the Run icon をクリックして、リストから必要なアクションを選択することもできます。

Run a TypeScript scratch file

自動生成された一時的な実行 / デバッグ構成

サーバー側の TypeScript コードを実行するためにどの方法を選択した場合でも、WebStorm は、実行とデバッグのために保存、編集、再利用できる Node.js タイプの一時的な実行 / デバッグ構成を作成します。

Node.js run/debug configuration for running and debugging server-side TypeScript

実行 / デバッグ構成の詳細を参照してください。

サーバー側の TypeScript コードをデバッグする

サーバー側の TypeScript は、プロジェクトツールウィンドウ Alt+1、エディター、実行ウィジェットからデバッグできます。

  1. 必要に応じてブレークポイントを設定します。

  2. プロジェクトツールウィンドウで、デバッグする TypeScript ファイルまたはアプリケーションの開始ファイルを右クリックし、コンテキストメニューからデバッグ <TypeScript ファイル名> を選択します。

Run server-side TypeScript from the Project tool window
  1. 必要に応じてブレークポイントを設定します。

  2. エディターで、デバッグする TypeScript ファイルまたはアプリケーションの開始ファイルを開き、コンテキストメニューからデバッグ <TypeScript ファイル名> を選択します。

Debug server-side TypeScript from the editor
  1. 必要に応じてブレークポイントを設定します。

  2. エディターで、デバッグする TypeScript ファイルまたはアプリケーションの開始ファイルを開きます。次に、ツールバーの実行ウィジェットから現在のファイルを選択し、その横にある the Debug icon をクリックします。

    または、実行ウィジェットから以前に作成した実行 / デバッグ構成を選択し、その横にある the Debug icon をクリックします。

Debug server-side TypeScript from the Run widget

TypeScript スクラッチファイルのデバッグ

スクラッチファイルをデバッグするには、上記の方法の他に、ガターの the Run icon をクリックして、リストから必要なアクションを選択することもできます。

Run a TypeScript scratch file

ts ノードを使用する

Node.js で単一の TypeScript ファイルを実行またはデバッグする必要がある場合は、TypeScript を JavaScript にコンパイルするに従ってコードをコンパイルする代わりに ts-node(英語) を使用できます。

ts-node をインストールする

  • 埋め込まれたターミナルAlt+F12)で、次のように入力します。

    npm install --save-dev ts-node

ts-node のカスタム Node.js 実行 / デバッグ構成を作成する

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

    Open the Edit Configurations dialog

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

  2. Node パラメーターフィールドに --require ts-node/register を追加します。

  3. 使用する Node.js インタープリターを指定します。

    プロジェクトエイリアスを選択すると、WebStorm は Node.js ページの Node インタープリターフィールドからプロジェクトの既定のインタープリターを自動的に使用します。ほとんどの場合、WebStorm はプロジェクトの既定のインタープリターを検出し、フィールド自体に入力します。

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

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

  4. ファイルフィールドで、実行またはデバッグする TypeScript ファイルを指定します。ワークフローに応じて、明示的に行うか、マクロを使用して行うことができます。

    • 常に同じ TypeScript ファイルを起動する場合は、the Browse button をクリックして、表示されるダイアログでこのファイルを選択します。デフォルトでは、実行 / デバッグ構成は選択したファイルの名前を取得します。

    • 別のファイルを起動する必要がある場合は、$FilePathRelativeToProjectRoot$ と入力します。このマクロを使用すると、WebStorm は常にアクティブなエディタータブでファイルを起動します。

    Custom run-debug configuration for ts-node
  5. 必要に応じて、アプリケーションパラメーターフィールドに ts-node の追加パラメーター ( --project tsconfig.json など) を指定します。

  6. 設定を保存します。

ts-node でサーバー側 TypeScript を実行する

実行 / デバッグ構成で TypeScript ファイルを指定した方法に応じて、次のいずれかを実行します。

  • ファイル名を明示的に入力した場合は、ツールバーの実行ウィジェットから必要な構成を選択し、リストの横にある the Run button をクリックするか、Shift+F10 を押します。

  • マクロを指定した場合は、エディターで実行する TypeScript ファイルを開き、ツールバーの実行ウィジェットから新しく作成された構成を選択し、the Run button をクリックするか、Shift+F10 を押します。

WebStorm は、実行ツールウィンドウに出力を表示します。

ts-node でサーバー側 TypeScript をデバッグする

  1. デバッグする TypeScript ファイルで、必要に応じてブレークポイントを設定します。

  2. 実行 / デバッグ構成で TypeScript ファイルを指定した方法に応じて、次のいずれかを実行します。

    • ファイル名を明示的に入力した場合は、ツールバーの実行ウィジェットから必要な構成を選択し、the Debug button をクリックするか、Shift+F9 を押します。

    • マクロを指定した場合は、エディターでデバッグする TypeScript ファイルを開き、実行ウィジェットから新しく作成された構成を選択して、the Debug button をクリックするか、Shift+F9 を押します。

クライアント側 TypeScript の実行とデバッグ

ブラウザーは JavaScript のみを処理するため、実行またはデバッグする前にクライアント側の TypeScript コードをコンパイルするを実行する必要があります。

コンパイルでは、TypeScript コードと実際に実行される JavaScript コード間の対応を設定するソースマップ(英語)を作成することもできます。

TypeScript を JavaScript にコンパイルする

TypeScript は、組み込みコンパイラーを使用してコンパイルすることも、または別々にあるいはビルドプロセスの一部として使用される他のツールを使用してコンパイルすることもできます。

デフォルトでは、組み込みコンパイラーは生成された JavaScript ファイルとソースマップを TypeScript ファイルの横に出力します。

状況ツールバーの TypeScript ウィジェットからコンパイルアクションを使用して手動でコンパイルを呼び出すことも、保存時に自動コンパイルを有効にすることもできます。

コンパイルエラーは TypeScript ツールウィンドウで報告されます。このリストは、コードに加えた変更の影響を受けず、コンパイルを再度呼び出したときにのみ更新されます。

ツールウィンドウは、TypeScript コードを手動でコンパイルした後にのみ表示されます。その後は、メインメニューの表示 | ツールウィンドウ | TypeScript またはツールウィンドウバーからツールウィンドウにアクセスできます。

始める前に

  1. Ctrl+Alt+S を押して設定を開き、言語 & フレームワーク | TypeScript を選択します。

  2. TypeScript 言語サービスチェックボックスが選択されていることを確認します。

tsconfig.json を作成して設定する

デフォルトでは、組み込みコンパイラーは、デバッグセッション中に TypeScript コードをステップスルーできるソースマップを作成しません。コンパイラーは、デフォルトで、アクティブなエディタータブの TypeScript ファイル、または現在のプロジェクトのすべての TypeScript ファイルも処理します。

tsconfig.json ファイルを使用すると、このデフォルトの動作を変更して、ソースマップを生成し、カスタムスコープのファイルのみをコンパイルできます。

tsconfig.json ファイルを作成する

  1. プロジェクトツールウィンドウ Alt+1 で、TypeScript コードがあるフォルダー (ほとんどの場合、プロジェクトのルートフォルダー) を選択し、コンテキストメニューから新規 | tsconfig.json ファイルを選択します。

  2. コンパイル時にソースマップを生成するには、sourceMap プロパティが true に設定されていることを確認してください。

  3. オプション :

    プロジェクト全体であるデフォルトのコンパイルスコープを上書きするには、files プロパティを追加し、処理するファイルの名前を次の形式で入力します。

    "files" : ["<file1.ts>","<file2.ts>"],

tsconfig.json のスコープを構成する

プロジェクト内のさまざまなファイルに、さまざまな TypeScript 構成を適用する必要がある場合があります。

各フォルダー内のすべてのファイルが同じ構成に従って処理されるようにソースを配置しても問題ありません。このような場合、フォルダーごとに個別の tsconfig.json を作成するだけで済みます。

ただし、同じフォルダーに保存されているファイルに異なるルールを適用する場合は、複数の構成ファイルを作成し、それらのスコープを構成する必要があります。

  1. tsconfig*.json 構成ファイルを必要な数だけ作成します。

  2. 設定ダイアログ (Ctrl+Alt+S) を開き、エディター | ファイルタイプに移動し、これらすべてのファイルの名前が TypeScript 構成ファイル名パターンリストのパターンと一致することを確認します。

    必要に応じて、ファイルの種類の関連付けを追加するの説明に従ってパターンを追加します。

    File Types: tsconfig.json patterns
  3. *tsconfig*.json で、その設定に従って処理するファイルを指定します。

    • files フィールドに明示的にファイル名をリストします。

      "files" : ["<file1.ts>","<file2.ts>"],

      TSConfig リファレンス: ファイル(英語)の詳細を参照してください。

    • include フィールドで、ファイル名またはパターンを指定します。

      "include" : ["<pattern1>, <pattern2>"]

      TSConfig リファレンス: 含める(英語)の詳細を参照してください。

    • 名前が include フィールドにリストされたパターンと一致する一部のファイルをスキップするには、その名前またはパターンを exclude フィールドにリストします。

      "exclude" : ["<pattern3>, <pattern4>"]

      TSConfig リファレンス: 除外(英語)の詳細を参照してください。

TypeScript コードのコンパイル

コンパイルを手動で呼び出すか、コードが変更されるたびに WebStorm にコードを自動的にコンパイルさせることができます。

あるいは、たとえば webpack(英語)babel(英語)、または別のツールを使用してビルドプロセスを構成することもできます。詳細については、webpack と TypeScript(英語) および Babel と TypeScript(英語) を参照してください。

手動コンパイル

  1. ステータスバーの言語サービスウィジェットをクリックします。

  2. the Compile icon をクリックします。

    Compile TypeScript code

    TypeScript のコンパイルポップアップで、次のいずれかのオプションを選択します。

    • アプリケーション全体の TypeScript コードをコンパイルするには、すべてをコンパイルを選択します。

      または、開いている TypeScript ファイルのコンテキストメニューから TypeScript のコンパイルを選択します。

      Compile TypeScript from context menu of a file
    • 1 つのファイルをコンパイルするには、TypeScript のコンパイルポップアップでそのファイルへのパスを選択します。

      TypeScript widget: compile current file
    • カスタムスコープからファイルをコンパイルするには、上記のように、ファイルが tsconfig.jsonfiles プロパティにリストされていることを確認します。

      TypeScript のコンパイルポップアップで、tsconfig.json へのパスを選択します。

      TypeScript widget: compile custom scope from tsconfig.json

変更時の自動コンパイル

  • 言語 & フレームワーク | TypeScript 設定ページ Ctrl+Alt+S を開き、変更時に再コンパイルするチェックボックスを選択します。

クライアント側の TypeScript アプリケーションを実行する

ブラウザーは JavaScript のみを処理するため、クライアント側の TypeScript コードを実行する前にコンパイルする必要があります。

クライアント側 TypeScript を実行する

  1. TypeScript コードを JavaScript にコンパイルします

  2. エディターで、生成された JavaScript ファイルへの参照を含む HTML ファイルを開きます。この HTML ファイルは、必ずしもアプリケーションの開始ページを実装するものである必要はありません。

  3. 以下のいずれか 1 つを実行します:

    • メインメニューから表示 | ブラウザーで開くを選択するか、Alt+F2 を押します。次にリストから目的のブラウザーを選択します。

    • コードの上にカーソルを置くと、ブラウザーのアイコンバー the WebStorm icon Chrome Firefox Safari Opera Internet Explorer Edge が表示されます。目的のブラウザーを示すアイコンをクリックします。

クライアント側 TypeScript のデバッグ

ブラウザーは JavaScript のみを処理するため、デバッグする前にクライアント側の TypeScript コードをコンパイルするを実行する必要があります。

コンパイル時に、TypeScript コードと実際に実行される JavaScript コードとの対応関係を設定するソースマップ(英語)も生成されます。これにより、TypeScript コードにブレークポイントを設定し、アプリケーションを起動してから、生成されたソースマップを利用して元の TypeScript コードをステップ実行することが可能になります。

アプリケーションが内蔵の WebStorm サーバーで実行されている場合は、上記のクライアント側の TypeScript アプリケーションを実行するを参照してください。組み込みサーバーで実行されている JavaScript と同じ方法でデバッグすることもできます。

Debug client-side TypeScript on the built-in server

外部 Web サーバーで実行されている TypeScript アプリケーションをデバッグする

ほとんどの場合、Node.js を使用するなど、外部の開発 Web サーバーで実行されているクライアント側アプリケーションをデバッグすることが必要になる場合があります。

Debug client-side TypeScript on an external server
  1. JavaScript デバッガーの構成の説明に従って、組み込みデバッガーを構成します。

  2. ソースマップの生成を有効にするには、tsconfig.json ファイルを作成するに従って、tsconfig.json を開き、sourceMap プロパティを true に設定します。

  3. TypeScript コードのブレークポイントの設定と設定

  4. アプリケーションを開発モードで実行します。多くの場合、そのために npm start を実行する必要があります。

    ほとんどの場合、この段階で TypeScript は JavaScript にコンパイルされ、ソースマップが生成されます。詳細については、TypeScript を JavaScript にコンパイルするを参照してください。

    開発サーバーの準備ができたら、ブラウザーでアプリケーションが実行されている URL アドレスをコピーします。実行 / デバッグ構成でこの URL アドレスを指定する必要があります。

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

    Open the Edit Configurations dialog

    開いた実行構成の編集ダイアログで、ツールバーの追加ボタン (the Add button) をクリックし、リストから JavaScript デバッグを選択します。開いた実行 / デバッグ構成: JavaScript デバッグダイアログで、アプリケーションが実行されている URL アドレスを指定します。この URL は、上記のステップ 3 に従って、ブラウザーのアドレスバーからコピーできます。

    Debug client-side TypeScript on an external server: run configuration
  6. ツールバーの実行ウィジェットリストから、新しく作成した 構成を選択し、その横にある the Debug button をクリックします。実行構成で指定された URL アドレスがブラウザーで開き、デバッグツールウィンドウが表示されます。

    デバッグツールウィンドウでコントロールを使用できるようにするには、ブラウザーでページをリフレッシュする必要がある場合があります。

  7. デバッグツールウィンドウでは、通常どおりに進めます。プログラムをステップ実行し、プログラムの実行を停止および再開し中断されたときにそれを調べ、コールスタックと変数を調べ、ウォッチを設定し、変数を評価し、実際の HTML DOM を表示するなどします。

関連ページ:

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

Angular アプリケーションを実行する:package.json のスクリプトの横にあるガターでクリックするか、ターミナルでコマンドを実行するか、npm ツールウィンドウ () でタスクをダブルクリックします。アプリケーションがコンパイルされ、開発サーバーの準備ができるまで待ちます。実行ツールウィンドウまたはターミナルには、アプリケーションが実行されている URL が表示されます。アプリケーションが @angular/cli で生成された場合、デフォルトの URL は http://local...

プラグインのインストール

プラグインは WebStorm のコア機能を拡張します。例: プラグインをインストールして、次の機能を取得します。バージョン管理システム、課題追跡システム、ビルド管理サーバー、その他のツールとの統合。さまざまな言語とフレームワークのコーディング支援サポート。ショートカットのヒント、ライブプレビュー、ファイルウォッチャーなど。新しいプログラミング言語を学ぶのに役立つコーディング演習。デフォルトでは、WebStorm には多数のプラグインがバンドルされています。バンドルされたプラグインを無効にするこ...

実行 / デバッグ構成

WebStorm は、実行 / デバッグ構成を使用して、コードを実行、デバッグ、テストします。各構成は、何を実行し、どのパラメーターと環境を使用するかを定義する、名前付きのスタートアッププロパティのセットです。実行 / デバッグ構成には 2 つのタイプがあります。一時的 — コンテキストメニューからを選択するたびに作成されます。コンテキストメニューを呼び出すには、オブジェクトまたは領域を右クリックします。永続的 — テンプレートから明示的に作成されるか、一時的な構成を保存することによって作成されま...

ブレークポイント

ブレークポイントは、特定のポイントでプログラムの実行を一時停止する特別なマーカーです。これにより、プログラムの状態と動作を調べることができます。ブレークポイントは、たとえば、特定のコード行に到達したときにプログラムを一時停止するなどの単純なものから、追加の条件をチェックしたり、ログに書き込んだりするなどのより複雑なロジックを含むものまであります。ブレークポイントは、一度設定すると、一時的なブレークポイントを除き、明示的に削除するまでプロジェクト内に残ります。ブレークポイントの種類:WebSto

実行 / デバッグ構成: Node.js

作成: 次の Node.js バージョンは、WebStorm 2023.3 以降でサポートされています。Node.js 20 - アクティブな長期サポート (LTS) バージョン、Node.js 21 - 現在のバージョン、サポートされている Node.js バージョンの詳細を参照してください。このページでは、構成固有の項目と、すべての実行 / デバッグ構成に共通のオプションについて説明します。この構成の使用方法の詳細については、「Node.js の実行とデバッグ」を参照してください。このダイアロ...

Node.js

このページは、プラグインのインストールに従って、設定 | プラグインページのインストール済みタブで Node.js バンドルプラグインが有効になっている場合にのみ表示されます。次の Node.js バージョンは、WebStorm 2023.3 以降でサポートされています。Node.js 20 - アクティブな長期サポート (LTS) バージョン、Node.js 21 - 現在のバージョン、サポートされている Node.js バージョンの詳細情報 Node インタープリターこのフィールドでは、現在のプロ...