RubyMine 2026.1 Help

Node.js のテスト

RubyMine を使用すると、多数のフレームワークで Node.js アプリケーションをテストできます。

現在のページでは、非同期テストシナリオの実行に特に役立つ JavaScript テストフレームワークである 組み込みの Node.js テストランナー(英語)または Mocha(英語) を使用したテストについて説明します。 RubyMine の外部から Mocha テストを実行し、ツリー表示にまとめられたテスト結果を確認し、そこからテストソースに簡単に移動できます。 エディターのテストの横に、RubyMine がテストのステータスを表示し、それをすばやく実行またはデバッグするオプションが用意されています。

始める前に

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

  2. JavaScript and TypeScript および Node.js の必須プラグインが 設定 | プラグイン ページ、 インストール済み タブで有効化されていることを確認してください。 詳細は、 プラグインの管理を参照してください。

組み込みの Node.js テストランナー

バージョン 20 以降、Node.js には 組み込みの Node.js テストランナー(英語)の安定バージョンが付属しています。 RubyMine は組み込みのテストランナーとの統合をサポートしているため、サードパーティフレームワークをインストールや設定せずにテストを実行できます。

TypeScript コードのテストもサポートされています。詳細については、 TypeScript をテストする を参照してください。

  1. Node.js バージョン 20 以降がコンピューターにインストールされており、 ローカル Node.js ランタイムとして構成されていることを確認してください。

  2. Node.js 公式 Web サイト(英語)の説明に従ってテストファイルを作成します。

  3. ガター内：

    • 単一のテストの横にある 実行テストアイコン をクリックして実行します。

    • テストスイートの横にある すべてのテストを実行アイコン をクリックして、テストスイート内のすべてのテストを実行します。

    Run tests from the editor with Node.js built-in test runner

  4. 実行 ツールウィンドウでテスト結果を調べ、詳細については テスト結果を調べるを参照してください。

  5. テストの再実行：

    • 単一のテストを再実行するには、 実行 ツールウィンドウでテストを選択し、コンテキストメニューから 「<test name>」を実行する。 を選択するか、 Alt+Shift+R を押します。

      実行ツールウィンドウから単一のテストを再実行する

      または、テストの横にあるガターアイコンを使用して再実行します。 無視されたテスト、失敗したテスト、成功したテストを再実行するには、「無視されたテストを実行アイコン」、「失敗したテストを再実行アイコン 」または「成功したテストを再実行アイコン 」をクリックします。

      Rerun a single test from the gutter

    • スイート全体を再実行するには、 実行 ツールウィンドウのツールバーで 「<suite name>」を再実行アイコン をクリックします。

      テストスイートを再実行する

      または、スイートの横にあるガターアイコンをクリックします。

      Rerun suite from the gutter

サードパーティのテストフレームワークを使用してコードをテストする

どのフレームワークも使用できますが、推奨されるのは Mocha です。

Mocha をインストールする

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

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

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

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

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

  2. Node.js 標準アサート機能(英語)の効率的な代替品として チャイ期待ライブラリ(英語)をインストールします。

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

    npm install --save-dev chai

Mocha テストを作成する

Mocha テストを実行する

RubyMine を使うと、エディターから Mocha テストを素早く実行したり、一部またはすべてのテストを実行できる実行 / デバッグ構成を作成できます。

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

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

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

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

    ガターのテストステータス

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

    テスト実行の監視
Mocha: テストの監視

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

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

    Mocha: 失敗したすべてのテストを再実行する

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

    失敗した単一のテストをエディターから再実行する: コンテキストメニュー

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

    失敗した単一のテストをエディターから再実行する: ガターアイコン

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

ナビゲーション

RubyMine を使うと、ファイルと関連するテストファイル間や テストランナータブのテスト結果からテストへ移動できます。

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

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

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

デバッグテスト

不明な理由でテストが失敗した場合は、テストをデバッグして、テストが古くなっているか、ソースコードへの変更によってアプリケーションの意図した動作が損なわれていないか確認できます。

RubyMine を使うと、エディターから Mocha テストのデバッグをすぐに開始したり、一部またはすべてのテストをデバッグする実行/デバッグ構成を作成できます。

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

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

  2. ガターで the Run button または the Rerun button をクリックし、リストから <test_name> をデバッグする。 を選択します。

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

Debug Mocha test

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

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

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

  3. 構成の一覧から Mocha 実行 / デバッグ構成を選択し、一覧またはツールバーの デバッグアイコン をクリックします。

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

失敗したテストをデバッグする詳細を参照してください。

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

RubyMine を使用すると、 Mocha テストによるカバレッジの状況も確認できます。 RubyMine は、この統計情報を専用の カバレッジ ツールウィンドウに表示し、カバーされた行とカバーされていない行をエディターと プロジェクト ツールウィンドウ (Alt+1) で視覚的にマークします。 カバレッジを監視するには、 Istanbul(英語) のコマンドラインインターフェースである nyc(英語) をインストールする必要があります。

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

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

    npm install&#xa0;--save-dev nyc

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

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

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

      カバレッジ付きの Mocha テストを開始する

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

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

    Mocha テスト: カバレッジレポート

Docker コンテナー内の Node.js でテストを実行する

RubyMine を使用すると、ローカルで行うのと同じ方法で Docker コンテナー内で Mocha テストを実行できます。

始める前に

  1. JetBrains Marketplace からプラグインをインストールする方法に従い、 設定 | プラグイン ページ、 Marketplace タブで Node.js および Node.js リモートインタープリター プラグインをインストールしてください。

  2. 設定で Docker プラグインが有効になっていることを確認します。 Ctrl+Alt+S を押して設定を開き、 プラグイン を選択します。 インストール済み タブをクリックします。 検索フィールドに 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. エディターの任意の場所を右クリックして、コンテキストメニューから 「パッケージマネージャー install」を実行する。 を選択します。

テストの実行

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

  2. ローカル開発と同様に操作してください。エディターから単一テストを実行・デバッグしたり、 テストの実行および テストのデバッグで説明されているように、実行/デバッグ構成を作成して一部または全テストを起動できます。

2026 年 6 月 2 日
Node.js アプリケーションでのライブ編集V8 CPU とメモリのプロファイリング