# TypeScript をテストする

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com/ja-jp/help/idea/llms.txt).

バージョン 20 以降、Node.js には [組み込みの Node.js テストランナー(英語)](https://nodejs.org/en/blog/announcements/v20-release-announce#stable-test-runner)の安定バージョンが付属しています。 IntelliJ IDEA は組み込みのテストランナーとの統合をサポートしているため、サードパーティのフレームワークをインストールして構成しなくてもテストを実行できます。

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

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

## 始める前に

Procedure:

1. Node.js バージョン 20 以降がコンピューターにインストールされ、 [ローカル Node.js ランタイム](developing-node-js-applications.html#ws_node_configure_local_node_interpreter)として構成されていることを確認してください。

2. ローダーをインストールします。 コマンドライン シェルまたは組み込みの   ターミナル   ( `Alt+F12` (Windows), `⌥ F12` (macOS), `⌥ F12` (IntelliJ IDEA Classic (macOS)), `⌘ ⌃ T` (macOS System Shortcuts), `Alt+F12` (XWin), `Alt+F12` (GNOME), `Alt+F12` (KDE), `Alt+F12` (Emacs), `Alt+F12` (Sublime Text), `⌥ F12` (Sublime Text (macOS)), `Ctrl+Alt+1` (Visual Studio), `⌘ ⌃ 1` (Visual Studio (macOS)), `Alt+F12` (NetBeans), `Alt+F12` (Eclipse), `⌥ F12` (Eclipse (macOS))) で、次を入力してください：

* `npm install --save-dev ts-node` で `ts-node` をインストールする

* `npm install --save-dev tsx` で `tsx` をインストールする

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

Procedure:

* テストを実行するには、その横のガターにある ![the Run test icon](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.gutter.run.svg) をクリックし、リストから   '<テスト名>' の実行   を選択します。

![Run tests from the editor with Node.js built-in test runner](https://resources.jetbrains.com/help/img/idea/2026.3/ts_test_node_test_runner_run_test_from_editor.animated.gif)

* スイート内のすべてのテストを実行するには、その横のガターにある ![「すべてのテストを実行」アイコン](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.actions.runAll.svg) をクリックし、リストから   '<スイート名>' の実行   を選択します。

![Run suites from the editor with Node.js built-in test runner](https://resources.jetbrains.com/help/img/idea/2026.3/ts_test_node_test_runner_run_suite_from_editor.animated.gif)

> **Tip:**
> ガターアイコンは、起動するテストや suite の状態に応じて変わります。詳しくは [テストの実行](performing-tests.html#gutter_icons_test_status)を参照してください。

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

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

![Node.js テストランナーの実行 / デバッグ構成](https://resources.jetbrains.com/help/img/idea/2026.3/ts_test_node_js_test_runner_run_config.png)

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

Procedure:

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

![構成の編集を開くダイアログ](https://resources.jetbrains.com/help/img/idea/2026.3/ws_client_ts_run_config_create.png)

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

2. 開いた   実行構成の編集   ダイアログで、ツールバーの   追加   ボタン ( ![追加ボタン](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg)) をクリックし、リストから   Node.js テストランナー   を選択します。

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

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

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

5. ローダ   リストから、使用するローダーを選択します。 デフォルトでは、 [tsx](https://tsx.is/) および [tsノード](https://typestrong.org/ts-node/) との統合がすぐに利用できます。

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

![TypeScript テスト: カスタムローダーを構成する](https://resources.jetbrains.com/help/img/idea/2026.3/ts_test_node_js_test_runner_run_config_custom_loader.png)

6. 実行   をクリックします。

または、   実行   ウィジェットから既存の実行 / デバッグ構成を選択し、その横にある ![the Debug icon](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.run.debug.svg) をクリックします。

## テスト結果を調べる

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

![テスト結果](https://resources.jetbrains.com/help/img/idea/2026.3/ws_ts_test_results.png)

詳細は [テスト結果を調べる](viewing-and-exploring-test-results.html)を参照してください。

## テストの再実行

Procedure:

* 単一のテストを再実行するには、   実行   ツールウィンドウでテストを選択し、コンテキストメニューから   '<テスト名>' の実行   を選択するか、 `Alt+Shift+R` (Windows), `⌘ ⌃ R` (macOS), `⌘ ⌃ R` (IntelliJ IDEA Classic (macOS)), `⌘ ⌃ R` (macOS System Shortcuts), `Alt+Shift+R` (XWin), `Alt+Shift+R` (GNOME), `Alt+Shift+R` (KDE), `Alt+Shift+R` (Emacs), `Alt+Shift+R` (Sublime Text), `⌘ ⌃ R` (Sublime Text (macOS)), `Alt+Shift+R` (Visual Studio), `Alt+Shift+R` (Visual Studio (macOS)), `Alt+Shift+R` (NetBeans), `Alt+Shift+G` (Eclipse), `⌘ ⌃ R` (Eclipse (macOS)) を押します。

![実行ツールウィンドウから単一のテストを再実行する](https://resources.jetbrains.com/help/img/idea/2026.3/ts_testing_node_test_runner_rerun_test_from_run_tool_window.png)

または、テストの横にあるガターアイコンを使用して再実行します。 無視されたテスト、失敗したテスト、成功したテストを再実行するには、 ![「無視されたテストを実行」アイコン](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.gutter.runFailed.svg)、 ![「失敗したテストを再実行」アイコン](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.gutter.runError.svg)、 ![「成功したテストを再実行」アイコン](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.gutter.runSuccess.svg) をクリックし、リストから   '<テスト名>' の実行   を選択します。

![Rerun a single test from the gutter](https://resources.jetbrains.com/help/img/idea/2026.3/ts_testing_node_test_runner_rerun_test_editor.animated.gif)

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

![Rerun suite from the gutter](https://resources.jetbrains.com/help/img/idea/2026.3/ts_testing_node_test_runner_rerun_suite_editor.animated.gif)

* 前回のセッションのすべてのテストを再実行するには、   実行   ツールウィンドウのツールバーで ![「<suite お名前>」を再実行アイコン。](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.run.rerun.svg) をクリックします。

![テストスイートを再実行する](https://resources.jetbrains.com/help/img/idea/2026.3/ts_testing_node_test_runner_rerun_suite_toolbar_icon.png)

## デバッグテスト

Procedure:

1. 必要に応じて [ブレークポイント](using-breakpoints.html)を設定します。

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

* テストをデバッグするには、テストの横のガターで ![the Run test icon](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.gutter.run.svg) をクリックし、リストから '<テスト名>' のデバッグ を選択します。

* スイート内のすべてのテストをデバッグするには、スイートの横のガターで ![the Run test icon](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.gutter.run.svg) をクリックし、リストから '<スイート名>' のデバッグ を選択します。 ![TypeScript テスト: エディターからスイートをデバッグする](https://resources.jetbrains.com/help/img/idea/2026.3/ts_test_node_test_runner_debug_suite_from_editor.png)

* または、 [上記のように](#ts_test_node_native_test_runner_run_configuration_create) Node.js テストランナー タイプの実行 / デバッグ構成を作成し、それを 実行 ウィジェットから選択して、その横にある ![the Debug icon](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.run.debug.svg) をクリックします。 ![TypeScript テスト: 実行 / デバッグ構成によるデバッグテスト](https://resources.jetbrains.com/help/img/idea/2026.3/ts_test_node_test_runner_debug_suite_from_rc.png)

