# Mocha

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

> **TL;DR**
> 必須プラグイン  ：
>
>
>
> `JavaScript and Typescript` 、  `Node.js`  - プラグインは CLion にバンドルされており、デフォルトで有効化されています。

[Mocha(英語)](http://mochajs.org/) は、非同期テストシナリオの実行に特に役立つ JavaScript テストフレームワークです。 CLion の外部から Mocha テストを実行し、ツリー表示でテスト結果を調べ、そこからテストソースに簡単に移動できます。 エディターでテストの横に、CLion はテストのステータスを表示し、すぐに実行またはデバッグするオプションを提供します。

## 始める前に

Procedure:

1. [Node.js](http://nodejs.org/#download) をダウンロードしてインストールします。

2. 必要な  JavaScript と TypeScript  および  Node.js  プラグインが   設定 | プラグイン   ページで有効化されていることを確認してください。 詳細については、 [プラグインの管理](managing-plugins.html)を参照してください。

## Mocha をインストールする

Procedure:

* コマンドライン シェルまたは埋め込み   ターミナルエミュレータ  （ `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)), `⌥ F12` (Xcode), `Ctrl+Alt+1` (Visual Studio), `⌘ ⌃ 1` (Visual Studio (macOS)), `Ctrl+Alt+1` (ReSharper), `⌘ ⌃ 1` (ReSharper (macOS)), `Alt+F12` (QtCreator), `⌥ F12` (QtCreator (macOS)), `Alt+F12` (NetBeans), `Alt+F12` (Eclipse), `⌥ F12` (Eclipse (macOS))）で、次のいずれかのコマンドを入力してください：

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

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

* `npm install --save-dev mocha` は、Mocha を [開発依存関係(英語)](https://docs.npmjs.com/getting-started/using-a-package.json#specifying-packages)としてインストールします。

[Mocha の公式サイトでスタートする(英語)](https://mochajs.org/#installation)詳細を参照してください。

## テストを書く

Procedure:

* [Mocha オフィシャル Web サイト(英語)](https://mochajs.org/)の指示に従ってテストを作成します。

## テストを実行

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

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

* ガターで ![the Run button](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.run.run.svg) または ![再実行ボタン](https://resources.jetbrains.com/help/img/idea/2026.3/app.actions.rerun.svg) をクリックし、リストから   実行 <テスト名>；   を選択します。

![エディターから Mocha テストを実行する](https://resources.jetbrains.com/help/img/idea/2026.3/ws_node_test_run_single_test.png)

ガターの  テストステータス アイコン ![テストが成功しました](https://resources.jetbrains.com/help/img/idea/2026.3/app.runConfigurations.testState.green2.svg) および ![テストが失敗しました](https://resources.jetbrains.com/help/img/idea/2026.3/app.runConfigurations.testState.red2.svg) により、エディターでテストが成功したか失敗したかを確認することもできます。

![ガターのテストステータス](https://resources.jetbrains.com/help/img/idea/2026.3/ws_node_test_mocha_status_gutter.png)

Procedure: Mocha 実行構成を作成する

1. [実行 / デバッグ構成](run-debug-configurations-dialog.html)ダイアログ (メインメニューの  `実行 | 実行構成の編集​`  ) を開き、左側のペインで ![追加ボタン](https://resources.jetbrains.com/help/img/idea/2026.3/デバッグ構成：Mocha](run-debug-configuration-mocha.html)ダイアログが開きます。

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

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

4. オプション:

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

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

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

```SHELL
./folder1/folder2/test/*.test.js

```

6. 実行するテストで使用する [インターフェース(英語)](http://mochajs.org/#interfaces)を選択します。

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

1. 構成の一覧から Mocha 実行/デバッグ構成を選択し、一覧またはツールバーの ![実行アイコン](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.run.run.svg) をクリックします。

2. 実行   ツールウィンドウの   テストランナー   タブで、テストの実行を監視し、テスト結果を分析します。 詳細については、 [テスト結果の検証](viewing-and-exploring-test-results.html) を参照してください。

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

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

3. 実行   ツールウィンドウの   テストランナー   タブで、テストの実行を監視し、テスト結果を分析します。 詳細については、 [テスト結果の検証](viewing-and-exploring-test-results.html) を参照してください。

![テスト実行の監視](https://resources.jetbrains.com/help/img/idea/2026.3/ws_node_test_mocha_monitor_tests_and_navigation.png)

Procedure: 失敗したテストを再実行

1. テスト結果ツールバーの ![再実行失敗テストアイコン](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.run.restartFailedTests.svg) をクリックします。 CLion は前回のセッション中に失敗したすべてのテストを実行します。

![Mocha: 失敗したすべてのテストを再実行する](https://resources.jetbrains.com/help/img/idea/2026.3/ws_node_test_mocha_rerun_failed_tests.png)

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

![失敗した単一のテストをエディターから再実行する: コンテキストメニュー](https://resources.jetbrains.com/help/img/idea/2026.3/ws_node_test_mocha_rerun_one_failed_test_context_menu.png)

3. または、失敗したテストの横にあるガターで ![失敗テストアイコン](https://resources.jetbrains.com/help/img/idea/2026.3/app.runConfigurations.testState.red2.svg) をクリックし、リストから  `<test name> を実行`  を選択します。

![失敗した単一のテストをエディターから再実行する: ガターアイコン](https://resources.jetbrains.com/help/img/idea/2026.3/ws_node_test_mocha_rerun_one_failed_test_gutter_icon.png)

詳細については、 [テストの再実行](performing-tests.html#rerun)を参照してください。

## ナビゲーション

CLion を使えば、ファイルと関連するテストファイルの間や、 [テストランナータブ](null)のテスト結果からテストにジャンプできます。

> **Tip:**
> このようなナビゲーションは、テストファイルが一般的な命名規則に従っている場合にのみ機能します。たとえば、  `.test.` 、  `.spec.` 、または  `_spec.` という接尾辞があり、ソースファイルの隣にあるか、  `test` フォルダーにある場合です。

Procedure:

* テストとそのサブジェクト間、またはその逆に移動するには、エディターでファイルを開き、コンテキストメニューから  `Go to | テスト`  または  `Go to | テスト対象`  を選択するか、 `Ctrl+Shift+T` (Windows), `⌘ ⇧ T` (macOS), `⌘ ⇧ T` (IntelliJ IDEA Classic (macOS)), `⌃ ⇧ T` (macOS System Shortcuts), `Ctrl+Shift+T` (XWin), `Ctrl+Shift+T` (GNOME), `Ctrl+Shift+T` (KDE), `Ctrl+Shift+T` (Emacs), `Ctrl+Shift+T` (Sublime Text), `Ctrl+Shift+T` (Sublime Text (macOS)), `⌘ ⇧ T` (Xcode), `Ctrl+Shift+T` (Visual Studio), `Ctrl+Shift+T` (Visual Studio (macOS)), `Ctrl+Shift+T` (ReSharper), `Ctrl+Shift+T` (ReSharper (macOS)), `Ctrl+Shift+T` (QtCreator), `Ctrl+Shift+T` (QtCreator (macOS)), `Ctrl+Shift+T` (NetBeans), `Ctrl+Shift+T` (Eclipse), `Ctrl+Shift+T` (Eclipse (macOS)) を押します。

* テスト結果からテスト定義に移動するには、「   テストランナー   」タブでテスト名を 2 回クリックするか、コンテキストメニューから「  `ソースに移動`  」を選択するか、単に `F4` (Windows), `⌘ ↓` (macOS), `F4` (IntelliJ IDEA Classic (macOS)), `F4` (macOS System Shortcuts), `F4` (XWin), `F4` (GNOME), `F4` (KDE), `F4` (Emacs), `F4` (Sublime Text), `F4` (Sublime Text (macOS)), `⌘ ↓` (Xcode), `F4` (Visual Studio), `⌘ ↓` (Visual Studio (macOS)), `F4` (ReSharper), `⌘ ↓` (ReSharper (macOS)), `F4` (QtCreator), `F4` (QtCreator (macOS)), `F4` (NetBeans), `F12` (Eclipse), `F3` (Eclipse (macOS)) を押します。 テストファイルがエディターで開き、テスト定義にキャレットが置かれます。

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

## デバッグテスト

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

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

1. デバッグするテストの横のガターにブレークポイントを設定します。   実行   ツールウィンドウでテストをダブルクリックするか、 `F4` (Windows), `⌘ ↓` (macOS), `F4` (IntelliJ IDEA Classic (macOS)), `F4` (macOS System Shortcuts), `F4` (XWin), `F4` (GNOME), `F4` (KDE), `F4` (Emacs), `F4` (Sublime Text), `F4` (Sublime Text (macOS)), `⌘ ↓` (Xcode), `F4` (Visual Studio), `⌘ ↓` (Visual Studio (macOS)), `F4` (ReSharper), `⌘ ↓` (ReSharper (macOS)), `F4` (QtCreator), `F4` (QtCreator (macOS)), `F4` (NetBeans), `F12` (Eclipse), `F3` (Eclipse (macOS)) を押すと、失敗したテストに移動できます。

2. ガターで ![the Run button](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.run.run.svg) または ![再実行ボタン](https://resources.jetbrains.com/help/img/idea/2026.3/app.actions.rerun.svg) をクリックし、リストから   <test_name> をデバッグ   を選択します。

3. デバッグ   ツールウィンドウで、通常どおり操作を続けます： [プログラムをステップ実行](stepping-through-the-program.html)、 [実行を停止・再開](null)、 [中断時の調査](examining-suspended-program.html)、コールスタックと変数の確認、ウォッチの設定、変数の評価、 [実際の HTML DOM の表示](viewing-actual-html-dom.html)などが可能です。

![Debug Mocha test](https://resources.jetbrains.com/help/img/idea/2026.3/ws_node_test_mocha_debug.animated.gif)

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

1. デバッグするテストの横にブレークポイントを設定します。   実行   ツールウィンドウでテストをダブルクリックするか、 `F4` (Windows), `⌘ ↓` (macOS), `F4` (IntelliJ IDEA Classic (macOS)), `F4` (macOS System Shortcuts), `F4` (XWin), `F4` (GNOME), `F4` (KDE), `F4` (Emacs), `F4` (Sublime Text), `F4` (Sublime Text (macOS)), `⌘ ↓` (Xcode), `F4` (Visual Studio), `⌘ ↓` (Visual Studio (macOS)), `F4` (ReSharper), `⌘ ↓` (ReSharper (macOS)), `F4` (QtCreator), `F4` (QtCreator (macOS)), `F4` (NetBeans), `F12` (Eclipse), `F3` (Eclipse (macOS)) を押すと、失敗したテストに移動できます。

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

3. 構成の一覧から Mocha 実行/デバッグ構成を選択し、一覧またはツールバーの ![デバッグアイコン](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.run.run.svg) をクリックします。

4. 開いた [デバッグツールウィンドウ](debug-tool-window.html)で、通常通りに操作します。 [プログラムをステップ実行](stepping-through-the-program.html)し、 [実行を停止や再開](null)し、中断時は [プログラムを確認](examining-suspended-program.html)、コールスタックと変数を調査し、ウォッチを設定し、変数を評価し、 [実際の HTML DOM を表示](viewing-actual-html-dom.html)などが行えます。

ソースマップを無視して実際に実行されるコードをステップ実行するには、 ![ソースマップ無効化トグルボタン](https://resources.jetbrains.com/help/img/idea/2026.3/sourceMapDisable.png) を   デバッグ   ツールウィンドウのツールバーで押します。

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

CLion を使用すると、コードがどの程度 [Mocha テストでカバーされて](http://en.wikipedia.org/wiki/Code_coverage)いるかを監視できます。 CLion は、専用の   カバレッジ  ツールウィンドウにこの統計情報を表示し、カバーされた行とカバーされていない行をエディターおよび   プロジェクト  ツールウィンドウ（ `Alt+1` (Windows), `⌘ 1` (macOS), `⌘ 1` (IntelliJ IDEA Classic (macOS)), `⌘ 1` (macOS System Shortcuts), `Alt+1` (XWin), `Alt+1` (GNOME), `Alt+1` (KDE), `Alt+1` (Emacs), `Alt+1` (Sublime Text), `⌘ 1` (Sublime Text (macOS)), `⌘ 1` (Xcode), `Ctrl+Alt+L` (Visual Studio), `⌘ ⌥ L` (Visual Studio (macOS)), `Alt+1` (ReSharper), `⌘ 1` (ReSharper (macOS)), `Alt+X` (QtCreator), `⌃ X` (QtCreator (macOS)), `Ctrl+1` (NetBeans), `Alt+1` (Eclipse), `Alt+1` (Eclipse (macOS))）で視覚的にマークします。 カバレッジを監視するには、 [Istanbul(英語)](https://istanbul.js.org/) のコマンドラインインターフェースである [nyc(英語)](https://github.com/istanbuljs/nyc) をインストールする必要があります。

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

* コマンドライン シェルまたは組み込みの   ターミナルエミュレータ  （ `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)), `⌥ F12` (Xcode), `Ctrl+Alt+1` (Visual Studio), `⌘ ⌃ 1` (Visual Studio (macOS)), `Ctrl+Alt+1` (ReSharper), `⌘ ⌃ 1` (ReSharper (macOS)), `Alt+F12` (QtCreator), `⌥ F12` (QtCreator (macOS)), `Alt+F12` (NetBeans), `Alt+F12` (Eclipse), `⌥ F12` (Eclipse (macOS))）で、次を入力します：

`npm install --save-dev nyc`

> **Tip:**
> また、イスタンブール自体、バージョン 1.1.0 以降をインストールすることもできます。 これらのバージョンは ES6 と TypeScript をサポートしています。

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

* テストを実行します：

* [上記のよう](#createRunConfigMocha)に Mocha 実行 / デバッグ構成を作成し、メインツールバーのリストから選択して、リストの右側にある ![カバレッジで実行](https://resources.jetbrains.com/help/img/idea/2026.3/app.general.runWithCoverage.svg) をクリックします。 ![カバレッジ付きの Mocha テストを開始する](https://resources.jetbrains.com/help/img/idea/2026.3/ws_node_test_mocha_run_with_coverage.png)

* または、エディターからのカバレッジを使用して特定のスイートまたはテストを実行します。左側のガターで ![the Run button](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.run.run.svg)または ![再実行ボタン](https://resources.jetbrains.com/help/img/idea/2026.3/app.actions.rerun.svg)をクリックし、リストから カバレッジで <test_name> を実行する を選択します。

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

CLion を使用すると、ローカルと同じ方法で Docker コンテナー内で [Mocha](http://mochajs.org/)テストを実行できます。

Procedure: 始める前に

1. Node.js  および  Node.js リモートインタープリター  プラグインを   設定 | プラグイン   ページにインストールします ( [JetBrains Marketplace からプラグインをインストールする](managing-plugins.html#install_plugin_from_repo) の説明に従います)。

2. 設定で  Docker  プラグインが有効になっていることを確認します。 `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `⌘ Comma` (Xcode), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (ReSharper), `⌘ Comma` (ReSharper (macOS)), `Ctrl+Alt+S` (QtCreator), `⌘ Comma` (QtCreator (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) を押して設定を開き、  `プラグイン`  を選択します。 検索フィールドに  Docker  と入力します。 プラグインの詳細については、 [プラグインの管理](managing-plugins.html)を参照してください。

3. Docker  をダウンロード、インストール、構成し、 [Docker プラグイン統合](docker.html) に記載されている手順に従ってください。

4. [Docker で Node.js リモートランタイムを構成する](node-with-docker.html#ws_node_docker_configure_interpreter)または [Docker Compose](node-with-docker-compose.html#ws_node_docker_compose_configure_interpreter) 経由でインストールし、プロジェクトの [デフォルトとして設定してください](node-with-docker.html#ws_node_docker_manage_dependencies)。 また、このリモートランタイムに関連付けられたパッケージマネージャーが [プロジェクトのデフォルトとして設定されている](node-with-docker.html#ws_node_docker_manage_dependencies)ことを確認してください。

5. `パッケージ.json​​`  を開き、Mocha が  `devDependencies`  セクションにリストされていることを確認します。

```JSON
{
    "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. エディターの任意の場所を右クリックして、コンテキストメニューから   「<package manager> install」を実行   を選択します。

Procedure: テストを実行

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

2. ローカル開発と同様に進めてください。エディターから単一のテストを実行およびデバッグしたり、上記の [テストの実行](#ws_mocha_running)や [テストのデバッグ](#ws_mocha_debugging)の説明に従って、テストの一部または全部を実行/デバッグ構成で起動できます。

## See also

### リファレンス

[実行 / デバッグ構成: Mocha](run-debug-configuration-mocha.html)

