Mocha

1. コンピューターに Node.js(英語) があることを確認してください。

2. 設定で Node.js プラグインが有効になっていることを確認します。 Ctrl+Alt+S を押して設定を開き、 プラグイン を選択します。 インストール済み タブをクリックします。 検索フィールドに Node.js と入力します。 プラグインの詳細については、 プラグインの管理を参照してください。

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

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

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

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

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

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

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

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

  

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

  

Mocha 実行構成を作成する

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

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

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

4. オプション:

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

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

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

   ./folder1/folder2/test/*.test.js

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

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

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

   

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

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

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

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

失敗したテストを再実行

1. テスト結果ツールバーの をクリックします。 WebStorm は前回のセッションで失敗したすべてのテストを実行します。

   

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

   

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

   

詳細は、 テストの再実行を参照してください。

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

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

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

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

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

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

3. デバッグ ツールウィンドウで、通常どおり操作してください： プログラムをステップ実行、 実行の停止および再開、 中断時に調査 、コールスタックや変数の確認、ウォッチの設定、変数の評価、 HTML DOM の確認などができます。

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

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

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

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

   

4. 開いた デバッグツールウィンドウ で、通常どおり操作してください： プログラムをステップ実行、 実行を停止・再開、 一時停止時の確認 、コールスタックや変数の調査、ウォッチの設定、変数の評価、 実際の HTML DOM の表示などが可能です。

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

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

  npm install --save-dev nyc

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

1. テストを開始：

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

     

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

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

   

始める前に

1. Node.js、 Node.js リモートインタープリター、 Dockerに必要なプラグインが 設定 | プラグイン ページ・タブ インストール済み で有効になっていることを確認してください。 詳細については、 プラグイン管理を参照してください。

2. Docker をダウンロード、インストール、設定し、 Docker の説明に従ってください。

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

4. package.json を開き、Mocha が 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", "eslint": "^8.1.0", "http-server": "^14.0.0", "mocha": "^9.1.3" } }

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

テストの実行

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

2. ローカル開発時と同様に進めてください。エディターから単一テストの実行・デバッグや、実行/デバッグ構成を作成して一部またはすべてのテストを起動できます。詳細は上記の テストを実行および テストをデバッグを参照してください。