TypeScript の実行とデバッグ
JetBrains Rider を使用すると、Node.js で実行されるサーバー側 TypeScript コードと、ブラウザーで実行されるクライアント側 TypeScript コードの両方を実行およびデバッグできます。
サーバー側 TypeScript の実行とデバッグ
JetBrains Rider を使用すると、事前に JavaScript にコンパイルしなくても、サーバー側の TypeScript コードを実行してデバッグできます。
サーバー側の複数の TypeScript ファイルアプリケーションの実行とデバッグには、JetBrains Rider は組み込みのローダーを使用します。単一のファイルを実行またはデバッグする場合は、実行 / デバッグ構成の TypeScript ローダーリストからなしを選択してローダーをオフにすることができます。
始める前に
コンピューターに Node.js(英語) 18 以上がインストールされていることを確認してください。
設定で Node.js プラグインが有効になっていることを確認します。Ctrl+Alt+S を押して設定を開き、を選択します。インストール済みタブをクリックします。検索フィールドに Node.js と入力します。プラグインの詳細については、プラグインのマッピングを参照してください。
サーバー側の TypeScript コードを実行する
サーバー側の TypeScript は、エクスプローラーツールウィンドウ Alt+1、エディター、実行ウィジェットから実行できます。
エクスプローラーツールウィンドウ Alt+1 で、実行する TypeScript ファイルまたはアプリケーションの開始ファイルを右クリックし、コンテキストメニューから を選択します。

エディターで、実行する TypeScript ファイルまたはアプリケーションの開始ファイルを開き、リストから を選択します。

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

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

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

実行 / デバッグ構成の詳細を参照してください。
サーバー側の TypeScript コードをデバッグする
サーバー側の TypeScript は、エクスプローラーツールウィンドウ Alt+1、エディター、実行ウィジェットからデバッグできます。
必要に応じてブレークポイントを設定します。
プロジェクトツールウィンドウで、デバッグする TypeScript ファイルまたはアプリケーションの開始ファイルを右クリックし、コンテキストメニューから を選択します。

必要に応じてブレークポイントを設定します。
エディターで、デバッグする TypeScript ファイルまたはアプリケーションの開始ファイルを開き、コンテキストメニューから を選択します。

必要に応じてブレークポイントを設定します。
エディターで、デバッグする TypeScript ファイルまたはアプリケーションの開始ファイルを開きます。次に、ツールバーの実行ウィジェットから現在のファイルを選択し、その横にある
をクリックします。
または、実行ウィジェットから以前に作成した実行 / デバッグ構成を選択し、その横にある
をクリックします。

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

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 は JavaScript ランタイムページのノードランタイムフィールドにあるプロジェクトのデフォルトインタープリターを自動的に使用します。ほとんどの場合、JetBrains Rider はプロジェクトのデフォルトランタイムを検出し、そのフィールドに自動的に入力します。
別の構成済みのローカルインタープリターまたはリモートインタープリターを選択するか、
をクリックして新しいインタープリターを構成することもできます。
ファイルフィールドで、実行またはデバッグする TypeScript ファイルを指定します。ワークフローに応じて、明示的に行うか、マクロを使用して行うことができます。
常に同じ TypeScript ファイルを起動する場合は、
をクリックして、表示されるダイアログでこのファイルを選択します。デフォルトでは、実行 / デバッグ構成は選択したファイルの名前を取得します。
別のファイルを起動する必要がある場合は、
$FilePathRelativeToProjectRoot$と入力します。このマクロを使用すると、JetBrains Rider は常にアクティブなエディタータブでファイルを起動します。

必要に応じて、アプリケーションパラメーターフィールドに
ts-nodeの追加パラメーター (--project tsconfig.jsonなど) を指定します。設定を保存します。
ts-node でサーバー側 TypeScript を実行する
実行 / デバッグ構成で TypeScript ファイルを指定した方法に応じて、次のいずれかを実行します。
ファイル名を明示的に入力した場合は、ツールバーの実行ウィジェットから必要な構成を選択し、リストの横にある
をクリックするか、Shift+F10 を押します。
マクロを指定した場合は、エディターで実行する TypeScript ファイルを開き、ツールバーの実行ウィジェットから新しく作成された構成を選択し、
をクリックするか、Shift+F10 を押します。
JetBrains Rider は、実行ツールウィンドウに出力を表示します。
ts-node でサーバー側 TypeScript をデバッグする
デバッグする TypeScript ファイルで、必要に応じてブレークポイントを設定します。
実行 / デバッグ構成で TypeScript ファイルを指定した方法に応じて、次のいずれかを実行します。
ファイル名を明示的に入力した場合は、ツールバーの実行ウィジェットから必要な構成を選択し、
をクリックするか、Shift+F9 を押します。
マクロを指定した場合は、エディターでデバッグする TypeScript ファイルを開き、実行ウィジェットから新しく作成された構成を選択して、
をクリックするか、Shift+F9 を押します。
クライアント側 TypeScript の実行とデバッグ
ブラウザーは JavaScript のみを処理するため、実行またはデバッグする前にクライアント側の TypeScript コードをコンパイルするを実行する必要があります。
コンパイルでは、TypeScript コードと実際に実行される JavaScript コード間の対応を設定するソースマップ(英語)を作成することもできます。
TypeScript を JavaScript にコンパイルする
TypeScript は、組み込みコンパイラーを使用してコンパイルすることも、または別々にあるいはビルドプロセスの一部として使用される他のツールを使用してコンパイルすることもできます。
デフォルトでは、組み込みコンパイラーは生成された JavaScript ファイルとソースマップを TypeScript ファイルの横に出力します。
状況ツールバーの TypeScript ウィジェットからコンパイルアクションを使用して手動でコンパイルを呼び出すことも、保存時に自動コンパイルを有効にすることもできます。
コンパイルエラーは TypeScript ツールウィンドウで報告されます。このリストは、コードに加えた変更の影響を受けず、コンパイルを再度呼び出したときにのみ更新されます。
ツールウィンドウは、TypeScript コードを手動でコンパイルした後にのみ表示されます。その後は、メインメニューの またはツールウィンドウバーからツールウィンドウにアクセスできます。
始める前に
Ctrl+Alt+S を押して設定を開き、 を選択します。
TypeScript 言語サービスチェックボックスが選択されていることを確認します。
tsconfig.json を作成して設定する
デフォルトでは、組み込みコンパイラーは、デバッグセッション中に TypeScript コードをステップスルーできるソースマップを作成しません。コンパイラーは、デフォルトで、アクティブなエディタータブの TypeScript ファイル、または現在のプロジェクトのすべての TypeScript ファイルも処理します。
tsconfig.json ファイルを使用すると、このデフォルトの動作を変更して、ソースマップを生成し、カスタムスコープのファイルのみをコンパイルできます。
tsconfig.json ファイルを作成する
ソリューションエクスプローラーでプロジェクトを右クリックするか、TypeScript コードがあるフォルダーを右クリックして、を選択します。
コンパイル時にソースマップを生成するには、
sourceMapプロパティがtrueに設定されていることを確認してください。オプション :
プロジェクト全体であるデフォルトのコンパイルスコープを上書きするには、
filesプロパティを追加し、処理するファイルの名前を次の形式で入力します。"files" : ["<file1.ts>","<file2.ts>"],
tsconfig.json のスコープを構成する
プロジェクト内のさまざまなファイルに、さまざまな TypeScript 構成を適用する必要がある場合があります。
各フォルダー内のすべてのファイルが同じ構成に従って処理されるようにソースを配置しても問題ありません。このような場合、フォルダーごとに個別の tsconfig.json を作成するだけで済みます。
ただし、同じフォルダーに保存されているファイルに異なるルールを適用する場合は、複数の構成ファイルを作成し、それらのスコープを構成する必要があります。
tsconfig*.json 構成ファイルを必要な数だけ作成します。
設定 / 環境設定ダイアログ (Ctrl+Alt+S) を開き、に移動し、これらすべてのファイルの名前が TypeScript 構成ファイル名パターンリストのパターンと一致することを確認します。
必要に応じて、ファイルの種類の関連付けを追加するの説明に従ってパターンを追加します。

各 *tsconfig*.json で、その設定に従って処理するファイルを指定します。
filesフィールドに明示的にファイル名をリストします。"files" : ["<file1.ts>","<file2.ts>"],TSConfig リファレンス: ファイル(英語)の詳細を参照してください。
includeフィールドで、ファイル名またはパターンを指定します。"include" : ["<pattern1>, <pattern2>"]TSConfig リファレンス: 含める(英語)の詳細を参照してください。
名前が
includeフィールドにリストされたパターンと一致する一部のファイルをスキップするには、その名前またはパターンをexcludeフィールドにリストします。"exclude" : ["<pattern3>, <pattern4>"]TSConfig リファレンス: 除外(英語)の詳細を参照してください。
TypeScript コードのコンパイル
コンパイルを手動で呼び出すか、コードが変更されるたびに JetBrains Rider にコードを自動的にコンパイルさせることができます。
あるいは、たとえば webpack(英語)、babel(英語)、または別のツールを使用してビルドプロセスを構成することもできます。詳細については、webpack と TypeScript(英語) および Babel と TypeScript(英語) を参照してください。
手動コンパイル
ステータスバーの言語サービスウィジェットをクリックします。
をクリックします。

TypeScript のコンパイルポップアップで、次のいずれかのオプションを選択します。
アプリケーション全体の TypeScript コードをコンパイルするには、すべてをコンパイルを選択します。
または、開いている TypeScript ファイルのコンテキストメニューから TypeScript のコンパイルを選択します。

1 つのファイルをコンパイルするには、TypeScript のコンパイルポップアップでそのファイルへのパスを選択します。

カスタムスコープからファイルをコンパイルするには、上記のように、ファイルが tsconfig.json の
filesプロパティにリストされていることを確認します。TypeScript のコンパイルポップアップで、tsconfig.json へのパスを選択します。

変更時の自動コンパイル
言語 & フレームワーク | TypeScript 設定ページ Ctrl+Alt+S を開き、変更時に再コンパイルするチェックボックスを選択します。
クライアント側の TypeScript アプリケーションを実行する
ブラウザーは JavaScript のみを処理するため、クライアント側の TypeScript コードを実行する前にコンパイルする必要があります。
クライアント側 TypeScript を実行する
エディターで、生成された JavaScript ファイルへの参照を含む HTML ファイルを開きます。この HTML ファイルは、必ずしもアプリケーションの開始ページを実装するものである必要はありません。
以下のいずれか 1 つを実行します:
メインメニューからを選択するか、Alt+F2 を押します。次にリストから目的のブラウザーを選択します。
コードの上にカーソルを置くと、ブラウザーのアイコンバー
が表示されます。目的のブラウザーを示すアイコンをクリックします。
クライアント側 TypeScript のデバッグ
ブラウザーは JavaScript のみを処理するため、デバッグする前にクライアント側の TypeScript コードをコンパイルするを実行する必要があります。
コンパイル時に、TypeScript コードと実際に実行される JavaScript コードとの対応関係を設定するソースマップ(英語)も生成されます。これにより、TypeScript コードにブレークポイントを設定し、アプリケーションを起動してから、生成されたソースマップを利用して元の TypeScript コードをステップ実行することが可能になります。
アプリケーションが内蔵の JetBrains Rider サーバーで実行されている場合は、上記のクライアント側の TypeScript アプリケーションを実行するを参照してください。組み込みサーバーで実行されている JavaScript と同じ方法でデバッグすることもできます。

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

JavaScript デバッガーの構成の説明に従って、組み込みデバッガーを構成します。
ソースマップの生成を有効にするには、tsconfig.json ファイルを作成するに従って、tsconfig.json を開き、
sourceMapプロパティをtrueに設定します。TypeScript コードのブレークポイントの設定と設定。
アプリケーションを開発モードで実行します。多くの場合、そのために
npm startを実行する必要があります。ほとんどの場合、この段階で TypeScript は JavaScript にコンパイルされ、ソースマップが生成されます。詳細については、TypeScript を JavaScript にコンパイルするを参照してください。
開発サーバーの準備ができたら、ブラウザーでアプリケーションが実行されている URL アドレスをコピーします。実行 / デバッグ構成でこの URL アドレスを指定する必要があります。
に移動します。または、ツールバーの実行ウィジェットから実行構成の編集を選択します。

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

ツールバーの実行ウィジェットリストから、新しく作成した 構成を選択し、その横にある
をクリックします。実行構成で指定された URL アドレスがブラウザーで開き、デバッグツールウィンドウが表示されます。
デバッグツールウィンドウでコントロールを使用できるようにするには、ブラウザーでページをリフレッシュする必要がある場合があります。
デバッグツールウィンドウでは、通常どおりに進めます。プログラムをステップ実行し、プログラムの実行を停止および再開し、中断されたときにそれを調べ、コールスタックと変数を調べ、ウォッチを設定し、変数を評価し、実際の HTML DOM を表示するなどします。
関連ページ:
プラグインのインストール
プラグインは JetBrains Rider のコア機能を拡張します。例: プラグインをインストールして、次の機能を取得します。バージョン管理システム、課題追跡システム、ビルド管理サーバー、その他のツールとの統合。さまざまな言語とフレームワークのコーディング支援サポート。ショートカットのヒント、ライブプレビュー、ファイルウォッチャーなど。新しいプログラミング言語を学ぶのに役立つコーディング演習。プラグイン設定を開くを押して設定を開き、を選択します。マーケットプレースタブを使用して、JetBrai...
実行 / デバッグ構成
JetBrains Rider は、実行 / デバッグ構成を使用して、コードを実行、デバッグ、デプロイ、テストします。各構成は、何を実行し、どのパラメーターと環境を使用するかを定義する、名前付きのスタートアッププロパティのセットです。実行 / デバッグ構成には 2 つのタイプがあります。一時的 — エディターから .NET 静的メソッドを実行 / デバッグするたびに作成されます。永続的 — テンプレートから明示的に作成されるか、一時的な構成を保存することによって作成されます。永続的な構成は、削除するま...
ブレークポイント
ブレークポイントを使用すると、特定のステートメントでプログラムの実行を一時停止し、変数値、コールスタック、その他のプログラムパラメーターを分析したり、式を評価したり、プログラムをステップ実行したりできます。JetBrains Rider では、次の型のブレークポイントを操作できます。行ブレークポイント、コード内の特定の文に設定できます。実行がこの行に達すると、デバッガーはプログラムの実行を中断します。行ブレークポイントは実行可能な行にのみ設定できます。コメント、宣言、空行は、行ブレークポイントの...
実行 / デバッグ構成: Node.js
作成: 次の Node.js バージョンは、JetBrains Rider 2023.3 以降でサポートされています。Node.js 22 - アクティブな長期サポート(LTS)バージョン、Node.js 24 - 現在のバージョン、サポートされている Node.js バージョンの詳細を参照してください。このダイアログで、コンピューター上の Node.js アプリケーションと一緒にデバッガーを開始するための構成を作成します。始める前に:Node.js をダウンロードしてインストールします。JetB...
JavaScript ランタイム
推奨ランタイム:このエリアでは、使用するランタイムを選択します。利用可能なランタイムのセットは、インストールされているプラグインによって異なります。パッケージマネージャー:このフィールドでは、現在のプロジェクトのパッケージマネージャー (npm、Yarn、pnpm、bun) を選択します。JetBrains Rider は、これらのマネージャーへの現在のシステムパスに、、エイリアスを使用します。カスタムインストールを使用するには、選択をクリックし、関連するパッケージマネージャーのインストール...
TypeScript ウィンドウ
TypeScript ツールウィンドウには、TypeScript コードのコンパイルエラーが一覧表示されます。このリストは、コードに加えた変更の影響を受けず、コンパイルを再度呼び出したときにのみ更新されます。JetBrains Rider は、言語およびフレームワーク: TypeScript に従って、TypeScript ページで TypeScript 言語サービスがアクティブ化されている場合にのみ、TypeScript ツールウィンドウを表示します。ツールウィンドウは、TypeScript コード...