JetBrains Rider 2024.1 ヘルプ

TypeScript の実行とデバッグ

JetBrains Rider を使用すると、Node.js で実行されているクライアント側の TypeScript コードと TypeScript コードを実行およびデバッグできます。

アプリケーションを実行またはデバッグする前に、TypeScript コードを JavaScript にコンパイルする必要があります。これは、ビルトイン TypeScript コンパイラーと、Node.js で TypeScript を実行するための ts-node(英語) など、他のツールを使用して実行できます。これは、個別に、またはビルドプロセスの一部として使用されます。

コンパイル中に、TypeScript コードと実際に実行される JavaScript コード間の対応を設定するソースマップ(英語)を生成することもできます。その結果、TypeScript コードにブレークポイントを設定し、タイプ JavaScript デバッグ(クライアント側コードの場合)または Node.js の実行 / デバッグ構成でアプリケーションを起動し、生成されたソースマップのおかげで元の TypeScript コードをステップ実行できます。

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

TypeScript でクライアントサイドアプリケーションを記述し、TypeScript を JavaScript にコンパイルするに従ってコードをコンパイルし、JavaScript で記述されたクライアントサイドアプリケーションとまったく同じ方法でアプリケーションを実行およびデバッグできます。唯一の違いは、TypeScript コードにブレークポイントを直接設定できることです。

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

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

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

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

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

クライアント側の TypeScript アプリケーションをデバッグする

アプリケーションが内蔵の JetBrains Rider サーバーで実行されている場合は、上記のクライアント側の 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 を表示し、コンソールで JavaScript コードスニペットを実行します。

Node.js を使用してサーバー側 TypeScript アプリケーションを実行およびデバッグする

JetBrains Rider を使用すると、Node.js 実行構成を介して Node.js でサーバー側の TypeScript コードを起動できます。TypeScript を JavaScript にコンパイルするに従って、実行またはデバッグする前に、TypeScript コードを JavaScript にコンパイルする必要があります。

デバッグの場合は、TypeScript コードと実際に実行される JavaScript コードとの間の対応関係を設定するソースマップ(英語)がコンパイルによって生成されることも確認してください。詳細については、tsconfig.json ファイルを作成するを参照してください。

Debugging server-side TypeScript

始める前に

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

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

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

Node.js 実行 / デバッグ構成を作成する

Node.js run/debug configuration for running and debugging server-side TypeScript
  1. 実行 | 実行構成の編集に進みます。あるいは、ツールバーのリストから実行構成の編集を選択します。

    Open the Edit Configurations dialog

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

  2. 開いた実行 / デバッグ構成: Node.js ダイアログで、使用する Node.js インタープリターを指定します。

    JavaScript ファイルフィールドで、それを開始するアプリケーションのメインファイルから生成されたコンパイル済みファイルを指定します。

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

Node.js でサーバー側 TypeScript を実行する

  1. TypeScript コードを JavaScript にコンパイルします。詳細については、TypeScript を JavaScript にコンパイルするを参照してください。

  2. 上記のようNode.js 実行 / デバッグ構成を作成します。

  3. ツールバーの実行 / デバッグ構成リストから、新しく作成した Node.js 構成を選択し、その横にある the Run button をクリックします。

Node.js を使用してサーバー側 TypeScript をデバッグする

  1. TypeScript コードを JavaScript にコンパイルします。詳細については、TypeScript を JavaScript にコンパイルするを参照してください。

  2. 必要に応じて、TypeScript コードにブレークポイントを設定します。

  3. 上記のようNode.js 実行 / デバッグ構成を作成します。

  4. ツールバーの実行 / デバッグ構成を選択リストから、新しく作成した Node.js 構成を選択し、その横にある the Debug button をクリックします。デバッグツールウィンドウが開きます。

  5. ブレークポイントでコードの実行をトリガする手順を実行します。

  6. JetBrains Rider に切り替えると、デバッグツールウィンドウのコントロールが有効になります。

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 インタープリターを指定します。

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

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

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

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

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

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

  6. 設定を保存します。

Custom run-debug configuration for ts-node

ts-node で TypeScript ファイルを実行する

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

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

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

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

ts-node を使用して TypeScript ファイルをデバッグする

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

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

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

    • マクロを指定した場合は、エディターでデバッグする TypeScript ファイルを開き、ツールバーのリストから新しく作成した構成を選択し、リストの横にある the Debug button をクリックするか、Shift+F9 を押します。

関連ページ:

TypeScript を JavaScript にコンパイルする

ブラウザーと Node.js は JavaScript のみを処理するため、TypeScript コードを実行またはデバッグする前にコンパイルする必要があります。コンパイルでは、TypeScript コードと実際に実行される JavaScript コード間の対応を設定するソースマップを作成することもできます。JetBrains Rider には、TypeScript コンパイラーが組み込まれています。デフォルトでは、生成された JavaScript ファイルとソースマップを TypeScript...

Chrome での JavaScript のデバッグ

JetBrains Rider は、client-sideJavaScript コード用の組み込みデバッガーを提供します。以下のビデオと手順では、このデバッガーの使用を開始するための基本的な手順を説明しています。始める前に:設定で JavaScript と TypeScript バンドルプラグインが有効になっていることを確認します。を押して設定を開き、を選択します。インストール済みタブをクリックします。検索フィールドに JavaScript と TypeScript と入力します。プラグインの詳細に...

JavaScript デバッガーの構成

JetBrains Rider は、client-sideJavaScript コード用の組み込みデバッガーを提供します。デバッグセッションを開始すると、ビルトインデバッガーが自動的に起動します。デバッグが正常に行われるようにするには、組み込みの Web サーバーポートを指定して、JetBrains Rider が他のデバッガーオプションに提案しているデフォルト設定を受け入れるだけで十分です。始める前に設定で JavaScript と TypeScript バンドルプラグインが有効になっていることを...

ブレークポイント

ブレークポイントを使用すると、特定のステートメントでプログラムの実行を一時停止し、変数値、コールスタック、その他のプログラムパラメーターを分析したり、式を評価したり、プログラムをステップ実行したりできます。JetBrains Rider では、次の型のブレークポイントを操作できます。行ブレークポイント、コード内の特定の文に設定できます。実行がこの行に達すると、デバッガーはプログラムの実行を中断します。行ブレークポイントは実行可能な行にのみ設定できます。コメント、宣言、空行は、行ブレークポイントの...

実行 / デバッグ構成: JavaScript デバッグ

作成: このダイアログを使用して、ビルトインまたは外部 Web サーバー上で実行されているアプリケーションで JavaScript をデバッグするための構成を作成し、Dart Web アプリケーションをデバッグします。JavaScript デバッグ固有の構成設定:URLJavaScript のデバッグ: このフィールドには、デバッグする JavaScript を参照する HTML ファイルの URL アドレスを指定します。ローカルデバッグの場合は、http://localhost:<buil...

デバッグウィンドウ

デバッガーセッションを開始すると、デバッグツールウィンドウが表示されます。このウィンドウを使用して、デバッガーセッションを制御し、プログラムデータ(フレーム、スレッド、変数など)を表示して分析し、さまざまなデバッガーアクションを実行します。これは、デバッグツールウィンドウの概要です。ツールウィンドウの使用に関する一般的な手順については、ツールウィンドウを参照してください。ツールウィンドウのタブを切り替えるには、とを押します。セッション:複数のデバッグセッションを同時に実行すると、それらはデ