Karma

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

2. JetBrains リポジトリからプラグインをインストールする説明に従って、設定 / 環境設定 | プラグインページで Karma プラグインをインストールして有効にします。

• 埋め込みターミナル（Alt+F12）で、以下のいずれかのコマンドを入力します。

  • Karma と必要なすべてのプラグインが package.json にすでに定義されている場合は npm install

  • Karma と必要なプラグイン（たとえば、karma-jasmine または jasmine-core）を開発の依存関係(英語)としてインストールするには:

    npm install --save-dev karma npm install --save-dev <required_karma_plugin> <another_required_karma_plugin>

  Karma オフィシャル Web サイト(英語)の詳細を参照してください。

Karma 構成ファイルを作成するには

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

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

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

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

   Karma ファイル: パターンマッチング(英語)も参照してください。

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

• 左側のガターの または をクリックして、リストから実行 <テスト名> を選択します。

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

Karma 実行構成を作成するには

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

2. 使用する Node.js インタープリターを指定してください。これはローカル Node.js インタープリターまたは Windows Subsystem for Linux の Node.js です。

   オプションで、Node.js に渡す Node.js 固有のオプションパラメーターと環境変数(英語)を指定します。

3. karma パッケージの場所と karma.conf.js へのパスを指定します。

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

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

   例: Headless Chrome でテストを実行またはデバッグするには、Karma オプションフィールドに --browsers ChromeHeadless と入力します。詳細はヘッドレス Chrome による自動テスト(英語)を参照してください。

   使用可能なすべての CLI オプションを表示するには、ターミナル Alt+F12 に karma start --help と入力します。

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

1. メインツールバーのリストから Karma 実行 / デバッグ構成を選択し、リストの右側にある をクリックします。

2. Karma テストサーバーは自動的に起動します。実行ツールウィンドウの Karma サーバータブで、テストサーバーからのメッセージを表示および分析します。

3. 実行ツールウィンドウのテストランナータブのテスト実行の監視。

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

• テストランナータブで、ツールバーの をクリックします。IntelliJ IDEA は前のセッションで失敗したすべてのテストを実行します。

  

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

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

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

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

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

• 左側のガターの または をクリックして、リストからデバッグ <テスト名> を選択します。

実行 / デバッグ構成を介してテストデバッグを開始するには

1. 上記の説明に従って、Karma 実行 / デバッグ構成を作成します。

2. メインツールバーのリストから Karma 実行 / デバッグ構成を選択し、リストの右側にある をクリックします。

3. 開いたデバッグツールウィンドウでは、通常どおり進む: テストをステップ実行、停止し、再開し、テストの実行を中断したときにテストを検討するように、と。

karma-coverage をインストールするには

• 埋め込みターミナル（Alt+F12）に次のように入力します。

  npm install --save-dev karma-coverage

karma-coverage 定義を構成ファイルに追加するには

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

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

   reporters: ['progress', 'coverage']

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

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

カバレッジでテストを開始する

1. 上記の説明に従って、Karma 実行 / デバッグ構成を作成します。

2. メインツールバーのリストから Karma 実行 / デバッグ構成を選択し、リストの右側にある をクリックします。

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

   

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

   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 は、すべてのファイルのカバレッジを持つ詳細なテキストテーブルを生成します。