TypeScript の実行とデバッグ
PyCharm を使用すると、Node.js で実行されるクライアント側の TypeScript コードとサーバー側の TypeScript コードの両方を実行およびデバッグできます。
クライアント側の TypeScript アプリケーションを実行する
アプリケーションを実行またはデバッグする前に、TypeScript コードを JavaScript にコンパイルする必要があります。これは、組み込みの TypeScript コンパイラーと、TypeScript を Node.js で実行するための ts-node(英語) などの他のツールを使用して実行できます。これらは、個別に、またはビルドプロセスの一部として使用されます。
コンパイル中に、TypeScript コードと実際に実行される JavaScript コード間の対応を設定するソースマップ(英語)を生成することもできます。その結果、TypeScript コードにブレークポイントを設定し、タイプ JavaScript デバッグ(クライアント側コードの場合)または Node.js の実行 / デバッグ構成でアプリケーションを起動し、生成されたソースマップのおかげで元の TypeScript コードをステップ実行できます。
TypeScript でクライアントサイドアプリケーションを記述し、TypeScript を JavaScript にコンパイルするに従ってコードをコンパイルし、JavaScript で記述されたクライアントサイドアプリケーションとまったく同じ方法でアプリケーションを実行およびデバッグできます。唯一の違いは、TypeScript コードにブレークポイントを直接設定できることです。
エディターで、生成された JavaScript ファイルへの参照を含む HTML ファイルを開きます。この HTML ファイルは、必ずしもアプリケーションの開始ページを実装するものである必要はありません。
以下のいずれか 1 つを実行します:
メインメニューから
を選択するか、Alt+F2 を押します。次にリストから目的のブラウザーを選択します。コードの上にカーソルを置くと、ブラウザーのアイコンバー が表示されます。目的のブラウザーを示すアイコンをクリックします。
クライアント側の TypeScript アプリケーションをデバッグする
アプリケーションが内蔵の PyCharm サーバーで実行されている場合は、上記のクライアント側の 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 を表示し、コンソールで JavaScript コードスニペットを実行します。
サーバー側の TypeScript コードの実行とデバッグ
PyCharm を使用すると、事前に JavaScript にコンパイルしなくても、サーバー側の TypeScript コードを実行してデバッグできます。
サーバー側の複数の TypeScript ファイルアプリケーションの実行とデバッグには、PyCharm は組み込みのローダーを使用します。単一のファイルを実行またはデバッグする場合は、実行 / デバッグ構成の TypeScript ローダーリストからなしを選択してローダーをオフにすることができます。
始める前に
コンピューターに Node.js(英語) 18 以上がインストールされていることを確認してください。
設定で Node.js プラグインが有効になっていることを確認します。Ctrl+Alt+S を押して設定を開き、 を選択します。インストール済みタブをクリックします。検索フィールドに Node.js と入力します。プラグインの詳細については、プラグインのマッピングを参照してください。
サーバー側の TypeScript コードを実行する
サーバー側の TypeScript は、プロジェクトツールウィンドウ Alt+1、エディター、実行ウィジェットから実行できます。
プロジェクトツールウィンドウ Alt+1 で、実行する TypeScript ファイルまたはアプリケーションの開始ファイルを右クリックし、コンテキストメニューから を選択します。
エディターで、実行する TypeScript ファイルまたはアプリケーションの開始ファイルを開き、リストから
を選択します。
エディターで、実行する TypeScript ファイルまたはアプリケーションの開始ファイルを開きます。次に、ツールバーの実行ウィジェットから現在のファイルを選択し、その横にある をクリックします。
または、実行ウィジェットから以前に作成した実行 / デバッグ構成を選択し、その横にある をクリックします。
TypeScript スクラッチファイルを実行する
スクラッチファイルを実行するには、上記の方法の他に、ガターの をクリックして、リストから必要なアクションを選択することもできます。
自動生成された一時的な実行 / デバッグ構成
サーバー側の TypeScript コードを実行するためにどの方法を選択した場合でも、PyCharm は、実行とデバッグのために保存、編集、再利用できる 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 インタープリターを指定します。
プロジェクトエイリアスを選択すると、PyCharm は Node.js ページの Node インタープリターフィールドからプロジェクトの既定のインタープリターを自動的に使用します。ほとんどの場合、PyCharm はプロジェクトの既定のインタープリターを検出し、フィールド自体に入力します。
別の構成済みのローカルインタープリターまたはリモートインタープリターを選択するか、 をクリックして新しいインタープリターを構成することもできます。
ファイルフィールドで、実行またはデバッグする TypeScript ファイルを指定します。ワークフローに応じて、明示的に行うか、マクロを使用して行うことができます。
常に同じ TypeScript ファイルを起動する場合は、 をクリックして、表示されるダイアログでこのファイルを選択します。デフォルトでは、実行 / デバッグ構成は選択したファイルの名前を取得します。
別のファイルを起動する必要がある場合は、
$FilePathRelativeToProjectRoot$
と入力します。このマクロを使用すると、PyCharm は常にアクティブなエディタータブでファイルを起動します。
必要に応じて、アプリケーションパラメーターフィールドに
ts-node
の追加パラメーター (--project tsconfig.json
など) を指定します。設定を保存します。
ts-node でサーバー側 TypeScript を実行する
実行 / デバッグ構成で TypeScript ファイルを指定した方法に応じて、次のいずれかを実行します。
ファイル名を明示的に入力した場合は、ツールバーの実行ウィジェットから必要な構成を選択し、リストの横にある をクリックするか、Shift+F10 を押します。
マクロを指定した場合は、エディターで実行する TypeScript ファイルを開き、ツールバーの実行ウィジェットから新しく作成された構成を選択し、 をクリックするか、Shift+F10 を押します。
PyCharm は、実行ツールウィンドウに出力を表示します。
ts-node でサーバー側 TypeScript をデバッグする
デバッグする TypeScript ファイルで、必要に応じてブレークポイントを設定します。
実行 / デバッグ構成で TypeScript ファイルを指定した方法に応じて、次のいずれかを実行します。
ファイル名を明示的に入力した場合は、ツールバーの実行ウィジェットから必要な構成を選択し、 をクリックするか、Shift+F9 を押します。
マクロを指定した場合は、エディターでデバッグする TypeScript ファイルを開き、実行ウィジェットから新しく作成された構成を選択して、 をクリックするか、Shift+F9 を押します。
関連ページ:
Angular
Angular は、クロスプラットフォームアプリケーションを構築するための一般的なフレームワークです。PyCharm は Angular のサポートを提供し、新しい Angular アプリの作成やコンポーネントの作業からデバッグやテストまで、開発プロセスのすべてのステップで役立ちます。始める前に:お使いのコンピューターに Node.js がインストールされていることを確認してください。設定 | プラグインページのインストール済みタブで、JavaScript and TypeScript および Angu...
TypeScript を JavaScript にコンパイルする
ブラウザーと Node.js は JavaScript のみを処理するため、TypeScript コードを実行またはデバッグする前にコンパイルする必要があります。コンパイルでは、TypeScript コードと実際に実行される JavaScript コード間の対応を設定するソースマップを作成することもできます。PyCharm には、TypeScript コンパイラーが組み込まれています。デフォルトでは、生成された JavaScript ファイルとソースマップを TypeScript ファイルの横に...
Chrome での JavaScript のデバッグ
PyCharm は、client-sideJavaScript コード用の組み込みデバッガーを提供します。始める前に:設定で JavaScript and TypeScript バンドルプラグインが有効になっていることを確認します。を押して設定を開き、を選択します。インストール済みタブをクリックします。検索フィールドに JavaScript and TypeScript と入力します。プラグインの詳細については、プラグインのマッピングを参照してください。設定で JavaScript Debugger バ...
JavaScript デバッガーの構成
PyCharm は、client-sideJavaScript コード用の組み込みデバッガーを提供します。デバッグセッションを開始すると、ビルトインデバッガーが自動的に起動します。デバッグが正常に行われるようにするには、組み込みの Web サーバーポートを指定して、PyCharm が他のデバッガーオプションに提案しているデフォルト設定を受け入れるだけで十分です。始める前に設定で JavaScript and TypeScript バンドルプラグインが有効になっていることを確認します。を押して設定を...
ブレークポイント
ブレークポイントは、特定のポイントでプログラムの実行を一時停止する特別なマーカーです。これにより、プログラムの状態と動作を調べることができます。ブレークポイントは、たとえば、特定のコード行に到達したときにプログラムを一時停止するなどの単純なものから、追加の条件をチェックしたり、ログに書き込んだりするなどのより複雑なロジックを含むものまであります。ブレークポイントは、一度設定すると、一時的なブレークポイントを除き、明示的に削除するまでプロジェクト内に残ります。ブレークポイントの種類:PyChar
実行 / デバッグ構成: JavaScript デバッグ
作成: このダイアログを使用して、ビルトインまたは外部 Web サーバー上で実行されているアプリケーションで JavaScript をデバッグするための構成を作成し、Dart Web アプリケーションをデバッグします。JavaScript デバッグ固有の構成設定:URLJavaScript のデバッグ: このフィールドには、デバッグする JavaScript を参照する HTML ファイルの URL アドレスを指定します。ローカルデバッグの場合は、http://localhost:<buil...