IntelliJ IDEA 2020.3 ヘルプ

Mocha

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

始める前に

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

  2. 設定 / 環境設定 | プラグインページで Node.js バンドルプラグインが有効になっていることを確認してください。詳細については、プラグインの管理を参照してください。

Mocha のインストール

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

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

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

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

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

npm、pnpm、Yarn に従って、Node.js と NPM ページmocha パッケージをインストールすることもできます。

テストを実行

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

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

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

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

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

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

  2. 使用するノードインタープリターと mocha パッケージの場所を指定します。

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

  4. 必要に応じて、関連するソースファイルの変更についてテストを自動的に再実行するように設定します。これを行うには、--watch フラグを追加 Mocha オプションフィールドに追加します。

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

    パターンを定義して、一致するファイル( *.test.js など)のテストのみを実行することもできます。テストを含むファイルが test フォルダーに格納されている場合は、このフォルダーへのパスを、./folder1/folder2/test/*.test.js などの作業ディレクトリを基準としたパターンで指定します。

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

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

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

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

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

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

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

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

ナビゲーション

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

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

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

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

デバッグテスト

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

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

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

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

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

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

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

コードカバレッジの監視

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

nyc をインストールするには

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

    npm install --save-dev nyc

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

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

  2. メインツールバーのリストから Mocha 実行 / デバッグ構成を選択し、リストの右側にある Run with Coverage をクリックします。
    または、エディターからのカバレッジを使用して特定のスイートまたはテストをすばやく実行します。左側のガターで the Run buttonun または the Rerun button をクリックし、リストからカバレッジで <test_name> を実行するを選択します。

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

    ws_mocha-coverage-report.png

関連ページ:

プラグインを管理する

このサイトのメニューやアクション名表記は日本語です。IntelliJ IDEA を日本語化するには、日本語言語パックのインストールを参照してください。プラグインは以下に示すように IntelliJ IDEA のコア機能を拡張します。バージョン管理システム、アプリケーションサーバー、およびその他のツールとの統合を提供する、さまざまな言語とフレームワークのコーディング支援サポートを追加する、ショートカットヒント、ライブプレビュー、ファイルウォッチャーなどで生産性を向上、コーディング演習と検証で新しい...

npm、pnpm、Yarn

IntelliJ IDEA は npm、Yarn、Yarn 2、pnpm と統合されているため、IDE 内から再利用可能なコードのパッケージをインストール、検索、更新、削除できます。Node.js と NPM ページは、パッケージを管理するための専用 UI を提供します。もちろん、組み込みのターミナルのコマンドラインからも実行できます。IntelliJ IDEA では、npm、Yarn、pnpm スクリプトを実行およびデバッグすることもできます。IntelliJ IDEA は、package.jso...

Node.js および NPM

このページは、プラグインの管理に従って、設定 / 環境設定 | プラグインページのインストール済みタブで Node.js バンドルプラグインが有効になっている場合にのみ表示されます。Node.js の操作方法については、Node.js アプリケーションの開発セクションを参照してください。次の Node.js バージョンが IntelliJ IDEA 2020.3 でサポートされています。Node.js 10、Node.js 12、Node.js 14、Node.js 15、サポートされている Node...

デバッグツールウィンドウ

デバッガーセッションを開始すると、デバッグツールウィンドウが表示されます。このウィンドウを使用して、デバッガーセッションを制御し、プログラムデータ(フレーム、スレッド、変数など)を表示して分析し、さまざまなデバッガーアクションを実行します。これは、デバッグツールウィンドウの概要です。ツールウィンドウの使用に関する一般的な手順については、ツールウィンドウを参照してください。デフォルトでは、プログラムがブレークポイントに到達するとデバッグツールウィンドウが開き、セッションが終了しても非表示にはなりま...

デバッガーセッションを開始する

デバッガーセッションの開始は、通常モードでのプログラムと非常に似ています。デバッガーはバックグラウンドで接続されているため、デバッガーセッションを開始するために特別な設定を行う必要はありません。IntelliJ IDEA からプログラムを実行できる場合は、同じ構成を使用してプログラムをデバッグすることもできます。このトピックは、実行 / デバッグ構成の理解に依存しています。IntelliJ IDEA は追加のセットアップなしで単純なアプリケーションをデバッグする方法を提供しますが、デバッガーを効...

中断されたプログラムを調べる

デバッガーセッションの開始後、デバッグツールウィンドウが表示され、次のいずれかが発生するまでプログラムが正常に実行されます。ブレークポイントがヒットしました、プログラムを手動で一時停止する、その後、プログラムは中断され、現在の状態を調べたり、実行を制御したり、実行時にさまざまなシナリオをテストしたりできます。誤ってデバッグツールウィンドウを閉じた場合は、メインメニューからを選択するか、を押して再度開きます。フレームを調べる:プログラムの状態はフレームで表されます。プログラムが一時停止すると、