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 コードにブレークポイントを直接設定できることです。
エディターで、生成された JavaScript ファイルへの参照を含む HTML ファイルを開きます。この HTML ファイルは、必ずしもアプリケーションの開始ページを実装するものである必要はありません。
以下のいずれか 1 つを実行します:
メインメニューから
を選択するか、Alt+F2 を押します。次にリストから目的のブラウザーを選択します。コードの上にカーソルを置くと、ブラウザーのアイコンバー
が表示されます。目的のブラウザーを示すアイコンをクリックします。
クライアント側の TypeScript アプリケーションをデバッグする
アプリケーションが内蔵の JetBrains Rider サーバーで実行されている場合は、上記のクライアント側の TypeScript アプリケーションを実行するを参照してください。組み込みサーバーで実行されている JavaScript と同じ方法でデバッグすることもできます。
![Debug client-side TypeScript on the built-in server](https://resources.jetbrains.com/help/img/rider/2024.1/ws_ts_debug_client_built_in_server.png)
外部 Web サーバーで実行されている TypeScript アプリケーションをデバッグする
ほとんどの場合、Node.js を使用するなど、外部の開発 Web サーバーで実行されているクライアント側アプリケーションをデバッグすることが必要になる場合があります。
![Debug client-side TypeScript on an external server](https://resources.jetbrains.com/help/img/rider/2024.1/ws_ts_debug_client_external_server.png)
JavaScript デバッガーの構成の説明に従って、組み込みデバッガーを構成します。
ソースマップの生成を有効にするには、tsconfig.json ファイルを作成するに従って、tsconfig.json を開き、
sourceMap
プロパティをtrue
に設定します。TypeScript コードのブレークポイントの設定と設定。
アプリケーションを開発モードで実行します。多くの場合、そのために
npm start
を実行する必要があります。ほとんどの場合、この段階で TypeScript は JavaScript にコンパイルされ、ソースマップが生成されます。詳細については、TypeScript を JavaScript にコンパイルするを参照してください。
開発サーバーの準備ができたら、ブラウザーでアプリケーションが実行されている URL アドレスをコピーします。実行 / デバッグ構成でこの URL アドレスを指定する必要があります。
実行構成の編集を選択します。
に進みます。あるいは、ツールバーのリストから開いた実行構成の編集ダイアログで、ツールバーの追加ボタン (
) をクリックし、リストから JavaScript デバッグを選択します。開いた実行 / デバッグ構成: JavaScript デバッグダイアログで、アプリケーションが実行されている URL アドレスを指定します。この URL は、上記のステップ 3 に従って、ブラウザーのアドレスバーからコピーできます。
ツールバーの実行 / デバッグ構成を選択リストから、新しく作成した 構成を選択し、その横にある
をクリックします。実行構成で指定された URL アドレスがブラウザーで開き、デバッグツールウィンドウが表示されます。
デバッグツールウィンドウでコントロールを使用できるようにするには、ブラウザーでページをリフレッシュする必要がある場合があります。
デバッグツールウィンドウで、通常どおりに処理を進めます。プログラムをステップ実行し、プログラムの実行を停止して再開し、中断されたときにプログラムを調べ、実際の 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](https://resources.jetbrains.com/help/img/rider/2024.1/ws_ts_debug_server_side.png)
始める前に
お使いのコンピューターに Node.js(英語) がインストールされていることを確認してください。
設定で Node.js プラグインが有効になっていることを確認します。Ctrl+Alt+S を押して設定を開き、 を選択します。インストール済みタブをクリックします。検索フィールドに Node.js と入力します。プラグインの詳細については、プラグインのマッピングを参照してください。
ソースマップの生成を有効にするには、tsconfig.json ファイルを作成するに従って、tsconfig.json を開き、
sourceMap
プロパティをtrue
に設定します。
Node.js 実行 / デバッグ構成を作成する
![サーバー側 TypeScript を実行およびデバッグするための Node.js 実行 / デバッグ構成 Node.js run/debug configuration for running and debugging server-side TypeScript](https://resources.jetbrains.com/help/img/rider/2024.1/ws_ts_server_side_node_rc.png)
実行構成の編集を選択します。
に進みます。あるいは、ツールバーのリストから開いた実行構成の編集ダイアログで、ツールバーの追加ボタン (
) をクリックし、リストから Node.js を選択します。
開いた実行 / デバッグ構成: Node.js ダイアログで、使用する Node.js インタープリターを指定します。
JavaScript ファイルフィールドで、それを開始するアプリケーションのメインファイルから生成されたコンパイル済みファイルを指定します。
Node.js の実行 / デバッグ構成の作成の詳細を参照してください。
Node.js でサーバー側 TypeScript を実行する
TypeScript コードを JavaScript にコンパイルします。詳細については、TypeScript を JavaScript にコンパイルするを参照してください。
上記のように Node.js 実行 / デバッグ構成を作成します。
ツールバーの実行 / デバッグ構成リストから、新しく作成した Node.js 構成を選択し、その横にある
をクリックします。
Node.js を使用してサーバー側 TypeScript をデバッグする
TypeScript コードを JavaScript にコンパイルします。詳細については、TypeScript を JavaScript にコンパイルするを参照してください。
必要に応じて、TypeScript コードにブレークポイントを設定します。
上記のように Node.js 実行 / デバッグ構成を作成します。
ツールバーの実行 / デバッグ構成を選択リストから、新しく作成した Node.js 構成を選択し、その横にある
をクリックします。デバッグツールウィンドウが開きます。
ブレークポイントでコードの実行をトリガする手順を実行します。
JetBrains Rider に切り替えると、デバッグツールウィンドウのコントロールが有効になります。
ts ノードを使用する
Node.js で単一の TypeScript ファイルを実行またはデバッグする必要がある場合は、TypeScript を JavaScript にコンパイルするに従ってコードをコンパイルする代わりに ts-node(英語) を使用できます。
ts-node をインストールする
埋め込まれたターミナル(Alt+F12)で、次のように入力します。
npm install --save-dev ts-node
ts-node のカスタム Node.js 実行 / デバッグ構成を作成する
実行構成の編集を選択します。
に進みます。あるいは、ツールバーのリストから開いた実行構成の編集ダイアログで、ツールバーの追加ボタン (
) をクリックし、リストから Node.js を選択します。実行 / デバッグ構成: Node.js ダイアログが開きます。
Node パラメーターフィールドに
--require ts-node/register
を追加します。使用する Node.js インタープリターを指定します。
プロジェクトエイリアスを選択すると、JetBrains Rider は Node.js ページの Node インタープリターフィールドからプロジェクトの既定のインタープリターを自動的に使用します。ほとんどの場合、JetBrains Rider はプロジェクトの既定のインタープリターを検出し、フィールド自体に入力します。
別の構成済みのローカルインタープリターまたはリモートインタープリターを選択するか、
をクリックして新しいインタープリターを構成することもできます。
JavaScript ファイルフィールドで、実行またはデバッグする TypeScript ファイルを指定します。ワークフローに応じて、明示的に行うか、マクロを使用して行うことができます。
常に同じ TypeScript ファイルを起動する場合は、
をクリックして、表示されるダイアログでこのファイルを選択します。デフォルトでは、実行 / デバッグ構成は選択したファイルの名前を取得します。
別のファイルを起動する必要がある場合は、
$FilePathRelativeToProjectRoot$
と入力します。このマクロを使用すると、JetBrains Rider は常にアクティブなエディタータブでファイルを起動します。
必要に応じて、アプリケーションパラメーターフィールドに
ts-node
の追加パラメーター (--project tsconfig.json
など) を指定します。設定を保存します。
![ts-node のカスタム実行デバッグ構成 Custom run-debug configuration for ts-node](https://resources.jetbrains.com/help/img/rider/2024.1/ws_ts_debug_ts_node.png)
ts-node で TypeScript ファイルを実行する
実行 / デバッグ構成で TypeScript ファイルを指定した方法に応じて、次のいずれかを実行します。
ファイル名を明示的に入力した場合は、ツールバーのリストから必要な構成を選択し、リストの横にある
をクリックするか、Shift+F10 を押します。
マクロを指定した場合は、TypeScript ファイルを開いてエディターで実行し、ツールバーのリストから新しく作成した構成を選択して、
をクリックするか、Shift+F10 を押します。
JetBrains Rider は、実行ツールウィンドウに出力を表示します。
ts-node を使用して TypeScript ファイルをデバッグする
関連ページ:
![](https://resources.jetbrains.com/help/img/rider/2024.1/ws_ts_config_pattern_list.png)
TypeScript を JavaScript にコンパイルする
ブラウザーと Node.js は JavaScript のみを処理するため、TypeScript コードを実行またはデバッグする前にコンパイルする必要があります。コンパイルでは、TypeScript コードと実際に実行される JavaScript コード間の対応を設定するソースマップを作成することもできます。JetBrains Rider には、TypeScript コンパイラーが組み込まれています。デフォルトでは、生成された JavaScript ファイルとソースマップを TypeScript...
![](https://resources.jetbrains.com/help/img/rider/2024.1/ws_quick_start_debug_built_in_server_1.png)
Chrome での JavaScript のデバッグ
JetBrains Rider は、client-sideJavaScript コード用の組み込みデバッガーを提供します。以下のビデオと手順では、このデバッガーの使用を開始するための基本的な手順を説明しています。始める前に:設定で JavaScript と TypeScript バンドルプラグインが有効になっていることを確認します。を押して設定を開き、を選択します。インストール済みタブをクリックします。検索フィールドに JavaScript と TypeScript と入力します。プラグインの詳細に...
![](https://resources.jetbrains.com/help/img/rider/2024.1/js_debugger_before_you_start_plugins.png)
JavaScript デバッガーの構成
JetBrains Rider は、client-sideJavaScript コード用の組み込みデバッガーを提供します。デバッグセッションを開始すると、ビルトインデバッガーが自動的に起動します。デバッグが正常に行われるようにするには、組み込みの Web サーバーポートを指定して、JetBrains Rider が他のデバッガーオプションに提案しているデフォルト設定を受け入れるだけで十分です。始める前に設定で JavaScript と TypeScript バンドルプラグインが有効になっていることを...
![](https://resources.jetbrains.com/help/img/rider/2024.1/breakpoint_condition_example.png)
ブレークポイント
ブレークポイントを使用すると、特定のステートメントでプログラムの実行を一時停止し、変数値、コールスタック、その他のプログラムパラメーターを分析したり、式を評価したり、プログラムをステップ実行したりできます。JetBrains Rider では、次の型のブレークポイントを操作できます。行ブレークポイント、コード内の特定の文に設定できます。実行がこの行に達すると、デバッガーはプログラムの実行を中断します。行ブレークポイントは実行可能な行にのみ設定できます。コメント、宣言、空行は、行ブレークポイントの...
![](https://pleiades.io/icons/rider.png)
実行 / デバッグ構成: JavaScript デバッグ
作成: このダイアログを使用して、ビルトインまたは外部 Web サーバー上で実行されているアプリケーションで JavaScript をデバッグするための構成を作成し、Dart Web アプリケーションをデバッグします。JavaScript デバッグ固有の構成設定:URLJavaScript のデバッグ: このフィールドには、デバッグする JavaScript を参照する HTML ファイルの URL アドレスを指定します。ローカルデバッグの場合は、http://localhost:<buil...
![](https://resources.jetbrains.com/help/img/rider/2024.1/rider_debug_window.png)
デバッグウィンドウ
デバッガーセッションを開始すると、デバッグツールウィンドウが表示されます。このウィンドウを使用して、デバッガーセッションを制御し、プログラムデータ(フレーム、スレッド、変数など)を表示して分析し、さまざまなデバッガーアクションを実行します。これは、デバッグツールウィンドウの概要です。ツールウィンドウの使用に関する一般的な手順については、ツールウィンドウを参照してください。ツールウィンドウのタブを切り替えるには、とを押します。セッション:複数のデバッグセッションを同時に実行すると、それらはデ