RubyMine 2026.1 Help

TypeScript をテストする

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

RubyMine は ts-nodetsx ローダー用のすぐに使える構成を提供しており、TypeScript テストを JavaScript に事前にコンパイルすることなく実行およびデバッグできます。 または、カスタムローダーをインストールして、 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 をインストールする

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

  • テストを実行するには、その横のガターにある 実行テストアイコン をクリックし、リストから 「<test name>」を実行する。 を選択します。

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

テスト結果を調べる

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

テスト結果

詳しくは テスト結果を調べるをご覧ください。

テストの再実行

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

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

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

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

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

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

デバッグテスト

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

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

    • テストをデバッグするには、テストの横のガターで 実行テストアイコン をクリックし、リストから '<テスト名>' のデバッグ を選択します。

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

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

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