# Karma

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

[Karma (英語)](http://karma-runner.github.io/0.12/) は、クライアント側 JavaScript をテストするためのツールです。 Karma は、実際のブラウザーで実行されているアプリケーションに対してテストを実行し、テスト結果の正確さと信頼性を保証します。 CLion integrates with Karma, so you can run, debug, and monitor coverage of your tests from inside the IDE. テスト結果はツリービューで確認でき、そこからテストソースに簡単に移動できます。 テストのステータスは、エディターでテストの横に表示され、すぐに実行したりデバッグすることができます。

## 始める前に

Procedure:

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

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

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

Karma 自体に加えて、  karma-jasmine  や  jasmine-core  などの追加のパッケージ (プラグイン) が必要です。 [Karma オフィシャル Web サイト(英語)](https://karma-runner.github.io/1.0/intro/installation.html)から詳細を参照してください。

Procedure:

1. コマンドライン シェルまたは組み込みの   ターミナルエミュレータ   （ `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))） を開いてください。

2. 次のいずれかのコマンドを入力してください：

* Karma と必要なすべてのプラグインが `パッケージ.json​​` にすでに定義されている場合は `npm install`

* [開発の依存関係(英語)](https://docs.npmjs.com/getting-started/using-a-package.json#specifying-packages)として Karma とプラグインをインストールするには: ``` npm install --save-dev karma npm install --save-dev <karma_plugin> <another_karma_plugin> ```

## Karma 構成ファイルを生成する

Karma テストは、対話モードで生成された  `karma.conf.js`  構成ファイルに従って実行されます。 プロジェクトにすでに  `karma.conf.js`  がある場合は、この手順をスキップしてください。 Karma 構成の詳細については、「 [Karma オフィシャル Web サイト(英語)](http://karma-runner.github.io/0.12/config/configuration-file.html)」を参照してください。

Procedure: Karma 構成ファイルを作成する

1. ターミナルエミュレータ   を開き、オペレーティングシステムに応じて次のいずれかを入力して  `karma.conf.js`  生成ウィザードを開始します。

* macOS および Linux の場合: `./node_modules/karma/bin/karma init`

* Windows の場合: ``` npm install -g karma-cli karma init ```

2. ウィザードの質問に答えて、使用するテストフレームワークと自動的にキャプチャーされるブラウザーを指定します。

[Karma ファイル: パターンマッチング(英語)](http://karma-runner.github.io/0.12/config/files.html)も参照してください。

## テストを実行

CLion では、単一の Karma テストをエディターからすばやく実行したり、実行/デバッグ構成を作成してテストの一部または全部を実行したりできます。

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) をクリックして、リストから   実行 <テスト名>；   を選択します。

ガターの  テストステータス アイコン ![テストが成功しました](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) により、エディターでテストが成功したか失敗したかを確認することもできます。

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

1. [実行 / デバッグ構成](run-debug-configurations-dialog.html)ダイアログ (メインメニューの  `実行 | 実行構成の編集​`  ) を開き、左側のペインで ![追加ボタン](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg) をクリックし、リストから   Karma   を選択します。 「 [実行/デバッグ構成: Karma](null)」ダイアログが開きます。

> **Tip:**
> または、   プロジェクト   ツールウィンドウ（ `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)) ）でテストファイルを選択し、コンテキストメニューから   <ファイル名> を作成；   を選択します。

2. 使用する Node.js ランタイムを指定します。

プロジェクト   エイリアスを選択すると、CLion は   ノードランタイム   フィールドの [JavaScript ランタイム](javascript-runtime.html)ページからプロジェクトデフォルトのインタープリターを自動的に使用します。 ほとんどの場合、CLion はプロジェクトのデフォルトランタイムを検出し、フィールドに自動的に入力します。

別の構成済みローカルインタープリターを選択するか、 ![参照ボタン](https://resources.jetbrains.com/help/img/idea/2026.3/app.general.ellipsis.svg) をクリックして新しいものを構成することもできます。

必要に応じて、Node.js に渡す [Node.js 固有のオプションパラメーター](run-debug-configuration-node-js.html#node_parameters)と [環境変数(英語)](https://www.w3schools.com/nodejs/nodejs_environment.asp)を指定します。

変数の定義は、   環境変数   フィールドにセミコロン (  `;` ) を区切りとして表示されます。例えば：

* `NODE_PATH` モジュール解決時に検索する追加ディレクトリのリストです。 リスト内のディレクトリを区切るには、macOS または Linux ではコロン ( `:` ) を、Windows ではセミコロン ( `;` ) を使用してください。

* `NODE_MODULE_CONTEXTS` 独自のグローバルコンテキストでモジュールをロードするには 1 に設定します。

* `NODE_DISABLE_COLORS` REPL の色を無効化するには 1 に設定します。

![環境変数](https://resources.jetbrains.com/help/img/idea/2026.3/nodeEnvironmentVariables.png)

または、フィールドの右側にある   閲覧   ![環境変数の編集](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.inline.variables.svg) をクリックし、表示される   環境変数   ダイアログで変数のリストを設定します：

* ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg) 、 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.remove.svg)、 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.copy.svg)、 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.paste.svg) ボタンを使用して、カスタム変数のリストを管理します。

* ダイアログには、使用可能なシステム環境変数のリストも表示されます。 現在の構成でシステム環境変数を使用しない場合は、 システム環境変数を含める チェックボックスをオフにしてください。

* 準備ができたら OK をクリックします。

3. `karma.conf.js`  へのパスを指定します。

4. 使用する  `karma`  パッケージを指定します。 これは次のいずれかです。

* Karma インストールホーム `/npm/node_modules/karma` 。 If you installed Karma regularly through the Node Package Manager , CLion detects the Karma installation home itself.

* `node_modules/@angular/cli` へのパス。

* [Nx(英語)](https://nx.dev/getting-started/intro) を使用している場合は、 `node_modules/nx` へのパス。

![Karma 実行 / デバッグ構成 - Karma パッケージを選択](https://resources.jetbrains.com/help/img/idea/2026.3/karma_run_config_select_karma_package.png)

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

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

7. 必要に応じて、Karma に渡すコマンドラインオプションを指定して、  `karma.conf.js`  構成ファイルのデフォルト設定を上書きします。

例: ヘッドレス Chrome でテストを実行またはデバッグするには、   Karma オプション   フィールドに  `--browsers ChromeHeadless`  と入力します。 詳細については、「 [ヘッドレス Chrome による自動テスト(英語)](https://developers.google.com/web/updates/2017/06/headless-karma-mocha-chai)」を参照してください。

> **Tip:**
> あるいは、  `karma.conf.js`  の  `browsers`  オプションに  `'ChromeHeadless'`  を追加します。

使用可能なすべての CLI オプションを表示するには、   ターミナルエミュレータ   `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)) に  `karma start --help`  と入力します。

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

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

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

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

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

![失敗した Karma テストを再開する](https://resources.jetbrains.com/help/img/idea/2026.3/ws_rerun_failed_tests_karma_button.png)

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

![1 つのテストを再実行](https://resources.jetbrains.com/help/img/idea/2026.3/ws_rerun_one_test.png)

* 前回のセッションからすべてのテストを再実行するには、テスト結果ツールバーの ![再実行ボタン](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.run.rerun.svg) をクリックするか、 `Ctrl+F5` (Windows), `⌘ R` (macOS), `⌃ F5` (IntelliJ IDEA Classic (macOS)), `⌘ R` (macOS System Shortcuts), `Ctrl+F5` (XWin), `Ctrl+F5` (GNOME), `Ctrl+5` (KDE), `Ctrl+F5` (Emacs), `Ctrl+F5` (Sublime Text), `⌘ R` (Sublime Text (macOS)), `⌘ R` (Xcode), `Ctrl+Alt+R` (Visual Studio), `⌘ ⌥ R` (Visual Studio (macOS)), `Ctrl+F5` (ReSharper), `Ctrl+F5` (ReSharper (macOS)), `Ctrl+F5` (QtCreator), `Ctrl+F5` (QtCreator (macOS)), `Ctrl+F5` (NetBeans), `Ctrl+F5` (Eclipse), `Ctrl+F5` (Eclipse (macOS)) を押します。

* 関連するソースコードを変更した後にテストを自動的に再実行するには、テスト結果ツールバーの ![「自動的に再実行」トグルボタン](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.actions.rerunAutomatically.svg) を押します。

詳細については、 [テストの再実行](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 では、単一の Karma テストのデバッグをエディターからすばやく開始したり、実行/デバッグ構成を作成してテストの一部または全部をデバッグしたりできます。

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

1. テスト中の [ブレークポイントを設定します](using-breakpoints.html)。

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> をデバッグ   を選択します。

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

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

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

3. 構成の一覧から Karma 実行/デバッグ構成を選択し、一覧またはツールバーで ![デバッグアイコン](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.run.debug.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) を   デバッグ   ツールウィンドウのツールバーで押します。

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

With CLion, you can also monitor how much of your code is [covered with Karma tests](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))）で視覚的にマークします。 カバレッジを監視するには、  karma-coverage  パッケージをインストールし、  `karma.conf.js`  を更新する必要があります。

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 karma-coverage`

Procedure: Karma-coverage 定義を構成ファイルに追加する

1. エディターで  `karma.conf.js`  を開きます。

2. `reporters`  定義を見つけ、  `coverage`  を次の形式の値のリストに追加します。

```JAVASCRIPT
reporters: ['progress', 'coverage']
                
```

3. `preprocessors`  定義を追加し、カバレッジスコープを次の形式で指定します。

```JAVASCRIPT
preprocessors: {'**/*.js': ['coverage']}
                
```

Procedure: カバレッジ付きでテストを開始する

1. [上記のよう](#createRunConfigKarma)に Karma 実行 / デバッグ構成を作成します。

2. 構成の一覧から Karma 実行/デバッグ構成を選択し、一覧またはツールバーで ![カバレッジ付き実行アイコン](https://resources.jetbrains.com/help/img/idea/2026.3/app.general.runWithCoverage.svg) をクリックします。

または、エディターのテストアイコンを使用して、特定のスイートまたはカバレッジ付きのテストをすばやく実行します。

![カバレッジ付きエディターから Karma テストを実行する](https://resources.jetbrains.com/help/img/idea/2026.3/ws_karma_run_test_from_editor_with_coverage.png)

3. [カバレッジ](null)ツールウィンドウでコードカバレッジを監視します。

Karma  テストが実行されるたびに、カバレッジレポートが実際にディスク上に生成されます。 カバレッジレポートの形式は、次のように設定ファイルで設定できます。

```
// karma.conf.js
module.exports = function(config) {
config.set({ ...
// optionally, configure the reporter
coverageReporter: { type : 'html', dir : 'coverage/' }
...
});};

```

次の  `type`  値を使用できます。

* `html` はアノテーション付きソースコードを含む一連の HTML ファイルを生成します。

* `lcovonly` は `lcov.info` ファイルを作成します。

* `lcov` は HTML + `.lcov` ファイルを生成します。 このフォーマットはデフォルトで適用されます。

* `cobertura` は、Hudson と簡単に統合するための `cobertura-coverage.xml` ファイルを生成します。

* `text-summary` は、通常はコンソールに、カバレッジの簡潔なテキスト要約を生成します。

* `text` は、すべてのファイルのカバレッジを持つ詳細なテキストテーブルを生成します。

