GoLand 2026.1 Help

Node.js のテスト

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

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

始める前に

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

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

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

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

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

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

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

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

  3. ガター内：

    • 単一のテストの横にある the Run test icon をクリックして実行します。

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

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

  4. 実行 ツールウィンドウでテスト結果を確認し、詳細は テスト結果を確認をご覧ください。

  5. テストの再実行:

    • 単一のテストを再実行するには、 実行 ツールウィンドウでテストを選択し、コンテキストメニューから 実行 '<テスト名>' を選択するか、 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 テストを実行する

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

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

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

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

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

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

Mocha 実行構成を作成する

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

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

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

  4. オプション:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

ナビゲーション

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

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

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

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

デバッグテスト

テストが不明な理由で失敗した場合、デバッグでテストが古いのか、ソースコードの変更によりアプリケーションの意図した動作が壊れたのかを調べられます。

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

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

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

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

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

Mocha テストをデバッグする

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

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

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

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

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

失敗したテストのデバッグの詳細をご覧ください。

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

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

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

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

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

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

  1. テストを開始：

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

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

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

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

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

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

始める前に

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

  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 年 5 月 22 日
Node.js アプリケーションでのライブ編集V8 CPU とメモリのプロファイリング