PyCharm 2024.3 ヘルプ

TypeScript をテストする

バージョン 20 以降、Node.js には組み込みの Node.js テストランナー(英語)の安定バージョンが付属しています。PyCharm は組み込みのテストランナーとの統合をサポートしているため、サードパーティのフレームワークをインストールして構成しなくてもテストを実行できます。

PyCharm は、ts-node(英語) および tsx(英語) ローダー用のすぐに使用できる構成を提供しているため、事前に JavaScript にコンパイルしなくても、TypeScript テストを実行してデバッグできます。または、カスタムローダーをインストールして、Node.js テストランナーの実行 / デバッグ構成を作成するの説明に従って構成することもできます。

エディターから直接テストを実行してデバッグしたり、Node.js テストランナータイプの実行 / デバッグ構成を起動したりできます。

始める前に

  1. Node.js バージョン 20 以降がコンピューターにインストールされており、ローカル Node.js インタープリターとして構成されていることを確認してください。

  2. ローダーをインストールします。組み込みターミナル (Alt+F12) で次のように入力します。

    • npm install --save-dev ts-nodets-node をインストールする

    • npm install --save-dev tsxtsx をインストールする

エディターからテストを実行する

  • テストを実行するには、その横のガターにある the Run test icon をクリックし、リストから実行 '<test name>' を選択します。

    Run tests from the editor with Node.js built-in test runner
  • スイート内のすべてのテストを実行するには、その横のガターにある the Run All tests icon をクリックし、リストから実行 '<suite name>' を選択します。

    Run suites from the editor with Node.js built-in test runner

実行構成を介してテストを実行する

実行 / デバッグ構成を介してテストを実行すると、複数のテストファイルからテストを実行する必要がある場合に役立ちます。実行 / デバッグ構成を使用するもう 1 つの利点は、カスタムローダーを構成するオプションがあることです。

Node.js Test Runner run/debug configuration

実行 / デバッグ構成を自分で作成することも、エディターからテストまたはスイートを実行するときに PyCharm が作成する Node.js テストランナータイプの一時的な実行 / デバッグ構成を保存、編集、再利用することもできます。

  1. 実行 | 実行構成の編集に移動します。または、ツールバーの実行ウィジェットから実行構成の編集を選択します。

    Open the Edit Configurations dialog

    または、以前に生成された一時的な実行 / デバッグ構成を選択します。

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

    実行 / デバッグ構成: Node.js テストランナーダイアログが開きます。

  3. 使用する Node.js インタープリター、作業ディレクトリを指定し、実行するテストの範囲を選択します。

  4. 言語リストから、TypeScript を選択します。

  5. ローダリストから、使用するローダーを選択します。デフォルトでは、tsx(英語) および ts -node(英語) との統合がすぐに使用できます。

    または、カスタムローダーをインストールして構成します。例: jiti(英語) をインストールし、Node オプションフィールドに -r jiti/register と入力します。

    TypeScript tests: configure a custom loader
  6. 実行をクリックします。

    または、実行ウィジェットから既存の実行 / デバッグ構成を選択し、その横にある the Debug icon をクリックします。

テスト結果を調べる

テスト結果は実行ツールウィンドウに表示されます。

Test results

テスト結果を調べるの詳細を参照してください。

テストの再実行

  • 単一のテストを再実行するには、実行ツールウィンドウでテストを選択し、コンテキストメニューから実行 '<test name>' を選択するか、Alt+Shift+R を押します。

    Rerun a single test from the Run tool window

    または、テストの横にあるガターアイコンを使用して再実行します。無視されたテスト、失敗したテスト、成功したテストを再実行するには、the Run Ignored Test iconthe Rerun Failed Test iconthe Rerun Successful Test icon をクリックし、リストから実行 '<test name>' を選択します。

    Rerun a single test from the gutter
  • スイート全体を再実行するには、スイートの横にあるガターアイコンをクリックし、リストから実行 '<suite name>' を選択します。

    Rerun suite from the gutter
  • 前回のセッションのすべてのテストを再実行するには、実行ツールウィンドウのツールバーで The Rerun '<suite name>' icon をクリックします。

    Rerun test suite

デバッグテスト

  1. 必要に応じてブレークポイントを設定します。

  2. デバッグを開始します:

    • テストをデバッグするには、テストの横のガターで the Run test icon をクリックし、リストからデバッグ '<test name>' を選択します。

    • スイート内のすべてのテストをデバッグするには、スイートの横のガターで the Run test icon をクリックし、リストからデバッグ '<suite name>' を選択します。

      TypeScript testing: debug a suite from the editor
    • または、上記のように Node.js テストランナータイプの実行 / デバッグ構成を作成し、それを実行ウィジェットから選択して、その横にある the Debug icon をクリックします。

      TypeScript testing: debug test via a run/debug configuration

関連ページ:

Node.js

Node.js は、サーバーやコマンドラインなど、ブラウザーの外部で JavaScript を実行するための軽量ランタイム環境です。PyCharm は Node.js と統合されており、アプリケーションの構成、編集、実行、デバッグ、テスト、プロファイリング、保守を支援します。Node.js がアプリケーションのローカルランタイムとして、または npm パッケージの管理、JavaScript リンターの実行、ツールのビルド、フレームワークのテストなどにのみ必要な場合は、Node.js をインストールす...

テストの実行

通常、PyCharm は、作成した実行 / デバッグ構成を実行することにより、他のアプリケーションと同じ方法でテストを実行およびデバッグします。その際、指定されたテストクラスまたはメソッドをテストランナーに渡します。多くの場合、コンテキストメニューからテストセッションを開始できます。この目的のために、実行およびデバッグコマンドは、特定のコンテキストメニューで提供されます。例: これらのコマンドは、プロジェクトツールウィンドウのテストクラス、ディレクトリ、パッケージで使用できます。エディターで現在...

実行 / デバッグ構成

PyCharm は、実行 / デバッグ構成を使用して、コードを実行、デバッグ、テストします。各構成は、何を実行し、どのパラメーターと環境を使用するかを定義する、名前付きのスタートアッププロパティのセットです。さまざまな起動プロパティを使用して、PyCharm がスクリプトを実行するために使用するさまざまな方法を定義できます。例: 異なる Python インタープリターを使用して同じコードを実行し、さまざまな環境変数のセットを提供し、代替ファイルから入力値を取得できます。実行 / デバッグ構成には...

テスト結果を調べる

PyCharm でテストが実行されている間、テスト実行は実行ツールウィンドウのその実行構成のタブに表示されます。テスト実行が終了すると、そのタブでテスト結果を確認できます。右側のコンソールには、現在のテストセッションの出力が表示されます。テストの実行に関する詳細情報と、テストが失敗したか無視された理由を確認できます。テスト結果リストの上にあるテスト結果ツールバーを使用すると、成功したテストと無視されたテストの表示と非表示を切り替えたり、各テストの実行にかかった時間を表示したり、テスト結果をエクス...

ブレークポイント

ブレークポイントは、特定のポイントでプログラムの実行を一時停止する特別なマーカーです。これにより、プログラムの状態と動作を調べることができます。ブレークポイントは、たとえば、特定のコード行に到達したときにプログラムを一時停止するなどの単純なものから、追加の条件をチェックしたり、ログに書き込んだりするなどのより複雑なロジックを含むものまであります。ブレークポイントは、一度設定すると、一時的なブレークポイントを除き、明示的に削除するまでプロジェクト内に残ります。ブレークポイントの種類:PyChar

File Watchers

File Watcher は PyCharm ツールであり、IDE でファイルを変更または保存するときに、コンパイラー、フォーマッタ、リンターなどのコマンドラインツールを自動的に実行できます。File Watchers には 2 つの専用コードインスペクションがあります。ファイル監視使用可能インスペクションは、定義済みの File Watcher が適用可能なすべてのファイルで実行されます。プロジェクトに関連する File Watcher が設定されていない場合、PyCharm は追加することを提...