IntelliJ IDEA 2026.1 Help

Node.js のテスト

IntelliJ IDEA を使用すると、多数のフレームワークを使用して Node.js アプリケーションをテストできます。

現在のページでは、非同期テストシナリオの実行に特に役立つ JavaScript テストフレームワークである 組み込みの Node.js テストランナー(英語)または Mocha(英語) を使用したテストについて説明します。 IntelliJ IDEA の外部から Mocha テストを実行し、ツリービューに配置されたテスト結果を調べ、そこからテストソースに簡単に移動できます。 エディターのテストの横に、IntelliJ IDEA はテストのステータスを表示し、テストをすばやく実行またはデバッグするオプションを提供します。

始める前に

  1. Node.js をダウンロードしてインストールします。

  2. 設定で JavaScript and TypeScript プラグインが有効になっていることを確認します。 Ctrl+Alt+S を押して設定を開き、 プラグイン を選択します。 インストール済み タブをクリックします。 検索フィールドに JavaScript と TypeScript と入力します。 プラグインに関する詳細は、 プラグインの管理を参照してください。

  3. JetBrains Marketplace からプラグインをインストールする説明に従って、 設定 | プラグイン ページの Marketplace タブで Node.js プラグインをインストールして有効にします。 このプラグインは IntelliJ IDEA Ultimate でのみ利用可能です。

組み込みの Node.js テストランナー

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

TypeScript コードのテストもサポートされています。詳細については、 TypeScript をテストする を参照してください。

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

  2. Node.js 公式 Web サイト(英語)の説明に従ってテストファイルを作成します。

  3. ガター内:

    • 単一のテストの横にある the Run test icon をクリックして実行します。

    • テストスイートの横にある the Run All tests icon をクリックして、テストスイート内のすべてのテストを実行します。

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

  4. 実行 ツールウィンドウでテスト結果を調べ、詳細については テスト結果を調べるを参照してください。

  5. テストの再実行:

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

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

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

      Rerun a single test from the gutter

    • スイート全体を再実行するには、 実行 ツールウィンドウのツールバーで The Rerun '<suite name>' icon をクリックします。

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

      または、スイートの横にあるガターアイコンをクリックします。

      Rerun suite from the gutter

サードパーティのテストフレームワークを使用してコードをテストする

任意のフレームワークを使用できますが、推奨されるのは Mocha です。

Mocha をインストールする

  1. 埋め込まれた ターミナル （Alt+F12 ）で、次のいずれかのコマンドを入力します。

    • npm install mocha をプロジェクトにローカルインストールします。

    • グローバルインストール用の npm install&#xa0;-g mocha

    • npm install&#xa0;--save-dev mocha は、Mocha を 開発依存関係(英語)としてインストールします。

    Mocha の公式サイトでスタートする(英語)詳細を参照してください。

  2. Node.js 標準アサート機能(英語)の効率的な代替品として チャイ期待ライブラリ(英語)をインストールします。

    組み込み ターミナル (Alt+F12) で次のように入力します。

    npm install --save-dev chai

Mocha テストを作成する

  1. Mocha オフィシャル Web サイト(英語)の指示に従ってテストを作成します。

  2. ユニットテストが保存されているフォルダーをテストソースフォルダーとしてマークします（コンテンツルート を参照）。

Mocha テストを実行する

IntelliJ IDEA を使用すると、Mocha テストをエディターから簡単に実行したり、実行 / デバッグ構成を作成してテストの一部または全部を実行することができます。

エディターから単一の Mocha テストを実行する

  • ガターで 実行ボタン または 再実行ボタン をクリックし、リストから <test_name> の実行 を選択します。

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

    ガターの テストステータスアイコン 成功したテスト および テストに失敗しました により、エディターでテストが成功したか失敗したかを確認することもできます。

    ガターのテストステータス

Mocha 実行構成を作成する

  1. 実行 / デバッグ構成ダイアログ (メインメニューの 実行 | 実行構成の編集) を開き、左側のペインで 追加ボタン をクリックし、リストから Mocha を選択します。 実行/デバッグ構成ダイアログ: Mocha が開きます。

  2. 使用する Node.js ランタイムと mocha パッケージのロケーションを指定します。

  3. アプリケーションの作業ディレクトリを指定します。 デフォルトでは、 作業ディレクトリ フィールドにはプロジェクトのルートフォルダーが表示されます。 この定義済みの設定を変更するには、目的のフォルダーへのパスを指定します。

  4. オプション:

    関連するソースファイルの変更時に自動的に再実行されるテストを構成します。 これを行うには、 追加 Mocha オプション フィールドに --watch フラグを追加します。

  5. 実行するテストを指定します。 これは、特定のテストまたはスイート、テストファイル全体、テストファイルを含むフォルダーにすることができます。

    一致するファイル（例: *.test.js ）のテストのみを実行するパターンを定義することもできます。 テストを含むファイルが別のフォルダー（例: test ）に保存されている場合は、パターン内でそのフォルダーへのパスを作業ディレクトリからの相対パスで指定します。

    ./folder1/folder2/test/*.test.js

  6. 実行するテストで使用する インターフェース(英語)を選択します。

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

  1. 構成のリストから Mocha 実行 / デバッグ構成を選択し、リストまたはツールバーの the Run icon をクリックします。

  2. 実行 ツールウィンドウの テストランナー タブで、テストの実行を監視し、テスト結果を分析します。 詳細については、 テスト結果を調べるを参照してください。

    • クリックして違いを確認する リンクを使用して 差分ビューアー を開き、実際の結果を期待値と比較します。

    • 選択したテストのファイル名がリンクとして表示されます。 このリンクをクリックして、ソースコードに移動します。

  3. 実行 ツールウィンドウの テストランナー タブで、テストの実行を監視し、テスト結果を分析します。 詳細については、 テスト結果を調べるを参照してください。

    テスト実行の監視
Mocha: テストの監視

失敗した Mocha テストを再実行する

  • テスト結果ツールバーの the Rerun Failed Tests icon をクリックします。 IntelliJ IDEA は、前回のセッション中に失敗したすべてのテストを実行します。

    Mocha: 失敗したすべてのテストを再実行する

  • 特定の失敗したテストを再実行するには、そのコンテキストメニューで <テスト名> の実行 を選択します。

    失敗した単一のテストをエディターから再実行する: コンテキストメニュー

  • または、失敗したテストの横にあるガターで the Failed Test icon をクリックし、リストから <テスト名> の実行 を選択します。

    失敗した単一のテストをエディターから再実行する: ガターアイコン

ナビゲーション

IntelliJ IDEA を使用すると、ファイルと関連テストファイルの間、または テストランナータブのテスト結果からテストに移動できます。

  • テストとそのサブジェクト間、またはその逆に移動するには、エディターでファイルを開き、コンテキストメニューから テスト(S) へ移動 または 移動先 | テスト対象 を選択するか、 Ctrl+Shift+T を押します。

  • テスト結果からテスト定義に移動するには、「テストランナー 」タブでテスト名を 2 回クリックするか、コンテキストメニューから「ソースに移動 」を選択するか、単に F4 を押します。 テストファイルがエディターで開き、テスト定義にキャレットが置かれます。

  • 失敗したテストの場合、IntelliJ IDEA はスタックトレースからテストの失敗ラインに移動します。 正確な行がスタックトレースにない場合は、テスト定義に移動します。

デバッグテスト

不明な理由でテストが失敗した場合は、テストをデバッグして、テストが古くなっているかどうか、ソースコードに加えた変更によって、アプリケーションの意図した動作が損なわれていないかどうかを確認できます。

IntelliJ IDEA を使用すると、エディターから Mocha テストのデバッグをすぐに開始することも、テストの一部または全部をデバッグするための実行 / デバッグ構成を作成することもできます。

エディターから単一のテストのデバッグを開始する

  1. デバッグするテストの横のガターにブレークポイントを設定します。 実行 ツールウィンドウでテストをダブルクリックするか、 F4 を押すと、失敗したテストに移動できます。

  2. ガターで 実行ボタン または 再実行ボタン をクリックし、リストから デバッグ <test_name> を選択します。

  3. デバッグ ツールウィンドウで、通常どおり続行します： プログラムをステップ実行し、 プログラムの実行を停止して再開し、 中断時に調べ 、コールスタックと変数を調べ、ウォッチを設定し、変数を評価し、 実際の HTML DOM を表示します。

Debug Mocha test

Mocha 実行 / デバッグ構成を使用したデバッグテスト

  1. デバッグするテストの横にブレークポイントを設定します。 実行 ツールウィンドウでテストをダブルクリックするか、 F4 を押すと、失敗したテストに移動できます。

  2. 上記のように Mocha 実行 / デバッグ構成を作成します。

  3. 構成のリストから Mocha 実行 / デバッグ構成を選択し、リストまたはツールバーの the Debug icon をクリックします。

  4. 開いた デバッグツールウィンドウ で、通常どおり続行します： プログラムをステップ実行し、 プログラムの実行を停止して再開し、 中断時に調べ 、コールスタックと変数を調べ、ウォッチを設定し、変数を評価し、 実際の HTML DOM を表示します。

失敗したテストをデバッグする詳細を参照してください。

コードカバレッジを監視する

IntelliJ IDEA を使用すると、 Mocha テストでカバーされている(英語)コードの量を監視することもできます。 IntelliJ IDEA は、専用の カバレッジ ツールウィンドウにこの統計を表示し、エディターおよび プロジェクト ツールウィンドウ（Alt+1 ）でカバーされた行とカバーされていない行を視覚的にマークします。 カバレッジを監視するには、 Istanbul(英語) のコマンドラインインターフェースである nyc(英語) をインストールする必要があります。

ニューヨークをインストールする

  • 組み込み ターミナル (Alt+F12) で次のように入力します。

    npm install&#xa0;--save-dev nyc

カバレッジでテストを実行する

  1. テストを開始します。

    • 上記のように Mocha 実行 / デバッグ構成を作成し、メインツールバーのリストから選択して、リストの右側にある Run with Coverage をクリックします。

      カバレッジ付きの Mocha テストを開始する

    • または、エディターからのカバレッジを使用して特定のスイートまたはテストを実行します。左側のガターで 実行ボタン または 再実行ボタン をクリックし、リストから <test_name> のカバレッジ付き実行 を選択します。

  2. カバレッジツールウィンドウでコードカバレッジを監視します。 このレポートには、テストでカバーされたファイルの数と、その中にカバーされている行の割合が表示されます。 レポートから、ファイルに移動して、どの行が覆われていたか（緑色にマーキングされているか、どの行が覆われていないか）、赤色に表示されているかを確認できます。

    Mocha テスト: カバレッジレポート

Docker コンテナー内の Node.js でテストを実行する

IntelliJ IDEA を使用すると、ローカルで実行するのと同じ方法で、Docker コンテナー内で Mocha(英語) テストを実行できます。

始める前に

  1. JetBrains マーケットプレイスからプラグインをインストールする説明に従って、 設定 | プラグイン ページの Marketplace タブに Node.js リモートインタープリタープラグインをインストールして有効にします。

  2. 設定 | プラグイン ページのタブ インストール済み で、 Node.js および Docker 必要なプラグインが有効になっていることを確認してください。 詳細は、 プラグインの管理を参照してください。

  3. Docker の説明に従って Dockerをダウンロード、インストール、および構成します。

  4. Docker で Node.js リモートランタイムを構成するまたは Docker Compose を介して、プロジェクトの デフォルトとして設定します。 また、このリモートランタイムに関連付けられたパッケージマネージャーが プロジェクトのデフォルトとして設定されていることを確認してください。

  5. package.json を開き、必要なテストフレームワークが devDependencies セクションにリストされていることを確認します。

    { "name": "node-express", "version": "0.0.0", "private": true, "dependencies": { "cookie-parser": "~1.4.4", "debug": "~2.6.9", "express": "~4.16.1", "http-errors": "~1.6.3", "morgan": "~1.9.1", "pug": "^3.0.2" }, "devDependencies": { "chai": "^4.3.4", "concurrently": "^6.3.0", "eslint": "^8.1.0", "http-server": "^14.0.0", "jest": "^27.3.1", "mocha": "^9.1.3", "nyc": "^15.1.0" } }

  6. エディターの任意の場所を右クリックして、コンテキストメニューから '<パッケージマネージャー> のインストール' の実行 を選択します。

テストの実行

  1. Mocha オフィシャル Web サイト(英語)の指示に従ってテストを作成します。

  2. ユニットテストが保存されているフォルダーをテストソースフォルダーとしてマークします（コンテンツルート を参照）。

  3. ローカル開発の場合と同様に続行します。エディターから直接単一のテストを実行およびデバッグするか、実行 / デバッグ構成を作成して、上記の テストの実行および デバッグテストに従ってテストの一部またはすべてを起動します。

2026 年 3 月 30 日
Node.js アプリケーションでのライブ編集V8 CPU とメモリのプロファイリング