IntelliJ IDEA 2026.1 Help

Mocha

Mocha(英語) は、非同期テストシナリオの実行に特に役立つ JavaScript テストフレームワークです。 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 でのみ利用可能です。

Mocha をインストールする

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

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

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

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

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

テストを書く

テストの実行

IntelliJ IDEA を使用すると、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. 実行 ツールウィンドウの テストランナー タブで、テストの実行を監視し、テスト結果を分析します。 詳細については、 テスト結果を調べるを参照してください。

    テスト実行の監視

失敗したテストの再実行

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

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

    失敗した単一のテストをエディターから再実行する: コンテキストメニュー
  3. または、失敗したテストの横にあるガターで 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

実行 / デバッグ構成を介してテストデバッグを起動する

  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 で Mocha テストを実行する

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 を開き、Mocha が 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", "eslint": "^8.1.0", "http-server": "^14.0.0", "mocha": "^9.1.3" } }
  6. エディターの任意の場所を右クリックして、コンテキストメニューから '<パッケージマネージャー> のインストール' の実行 を選択します。

テストの実行

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

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

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

2026 年 3 月 30 日