IntelliJ IDEA 2026.1 Help

TypeScript をテストする

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

IntelliJ IDEA は、 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 をクリックし、リストから '<テスト名>' の実行 を選択します。

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

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

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

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

Node.js テストランナーの実行 / デバッグ構成

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

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

    構成の編集を開くダイアログ

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

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

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

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

  4. 言語 リストから TypeScript を選択してください。

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

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

    TypeScript テスト: カスタムローダーを構成する
  6. 実行 をクリックします。

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

テスト結果を調べる

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

テスト結果

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

テストの再実行

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

    実行ツールウィンドウから単一のテストを再実行する

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

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

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

    テストスイートを再実行する

デバッグテスト

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

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

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

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

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

      TypeScript テスト: 実行 / デバッグ構成によるデバッグテスト
2026 年 3 月 30 日