PyCharm 2024.3 ヘルプ

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 コードにブレークポイントを直接設定できることです。

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

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

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

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

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

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

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

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

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

サーバー側の複数の TypeScript ファイルアプリケーションの実行とデバッグには、PyCharm は組み込みのローダーを使用します。単一のファイルを実行またはデバッグする場合は、実行 / デバッグ構成の 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 コードを実行するためにどの方法を選択した場合でも、PyCharm は、実行とデバッグのために保存、編集、再利用できる 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 インタープリターを指定します。

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

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

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

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

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

  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 を押します。

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

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

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

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

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

    • マクロを指定した場合は、エディターでデバッグする TypeScript ファイルを開き、実行ウィジェットから新しく作成された構成を選択して、the Debug button をクリックするか、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...