Node.js のテスト

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

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

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

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

  

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

  

Mocha 実行構成を作成する

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

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

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

4. オプション:

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

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

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

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

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

1. 構成のリストから Mocha 実行 / デバッグ構成を選択し、リストまたはツールバーの をクリックします。

2. 実行ツールウィンドウのテストランナータブで、テストの実行を監視し、テスト結果を分析します。詳細については、テスト結果を調べるを参照してください。

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

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

3. 実行ツールウィンドウのテストランナータブで、テストの実行を監視し、テスト結果を分析します。詳細については、テスト結果を調べるを参照してください。

   

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

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

  

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

  

• または、失敗したテストの横にあるガターで をクリックし、リストから実行 <テスト名> を選択します。

  

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

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

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

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

1. デバッグするテストの横のガターにブレークポイントを設定します。実行ツールウィンドウでテストをダブルクリックするか、F4 を押すと、失敗したテストに移動できます。

2. ガターで または をクリックし、リストからデバッグ <テスト名> を選択します。

3. デバッグツールウィンドウで、通常どおりに処理を進めます。プログラムをステップ実行し、プログラムの実行を停止して再開し、中断されたときにプログラムを調べ、実際の HTML DOM を表示し、コンソールで JavaScript コードスニペットを実行します。

Mocha 実行 / デバッグ構成を使用したデバッグテスト

1. デバッグするテストの横にブレークポイントを設定します。実行ツールウィンドウでテストをダブルクリックするか、F4 を押すと、失敗したテストに移動できます。

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

3. 構成のリストから Mocha 実行 / デバッグ構成を選択し、リストまたはツールバーの をクリックします。

4. 開いたデバッグツールウィンドウでは、通常通りに進めます。テストをステップ実行、テスト実行の停止・再開、中断中のテストを調査、デバッガーコンソールで JavaScript のコードスニペットを実行、などです。

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

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

  npm install --save-dev nyc

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

1. テストを開始します。

   • 上記のように Mocha 実行 / デバッグ構成を作成し、メインツールバーのリストから選択して、リストの右側にある をクリックします。

     

   • または、エディターからのカバレッジを使用して特定のスイートまたはテストを実行します。左側のガターで または をクリックし、リストからカバレッジで <test_name> を実行するを選択します。

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

   

始める前に

1. JetBrains マーケットプレイスからプラグインをインストールする説明に従って、設定 | プラグインページのマーケットプレースタブに Node.js リモートインタープリタープラグインをインストールして有効にします。

2. 設定 | プラグインページのインストール済みタブで、Node.js および Docker に必要なプラグインが有効になっていることを確認します。詳細については、「プラグインのマッピング」を参照してください。

3. Docker の説明に従って、Docker をダウンロード、インストール、設定します。

4. Docker で Node.js リモートインタープリターを構成するまたは Docker Compose を介して、プロジェクトのデフォルトとして設定します。また、このリモートインタープリターに関連付けられているパッケージマネージャーがプロジェクトのデフォルトとして設定されていることを確認してください。

5. package.json を開き、必要なテストフレームワークが 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", "concurrently": "^6.3.0", "eslint": "^8.1.0", "http-server": "^14.0.0", "jest": "^27.3.1", "mocha": "^9.1.3", "nyc": "^15.1.0" } }

6. エディターの任意の場所を右クリックして、コンテキストメニューから実行 '<package manager> install' を選択します。

テストの実行

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

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

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