PyCharm 2026.1 Help

Node.js のテスト

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

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

始める前

  1. お使いのコンピューターに Node.js(英語) がインストールされていることを確認してください。

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

  3. JetBrains マーケットプレイスからプラグインをインストールする説明に従って、 設定 | プラグイン ページの マーケットプレース タブで Node.js プラグインをインストールして有効化してください。 このプラグインは PyCharm Pro でのみ利用できます。

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

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

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 テストを実行する

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

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

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

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

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

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

Mocha 実行構成を作成する

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

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

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

  4. オプション:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

ナビゲーション

PyCharm を使用すると、ファイルと関連するテストファイル間、または Test Runner タブのテスト結果からテストへジャンプできます。

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

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

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

デバッグテスト

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

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

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

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

  2. ガターで 実行ボタン または 再実行ボタン をクリックし、リストから デバッグ <test_name> を選択します。

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

Debug Mocha test

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

始める前

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

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

  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. ローカル開発と同様に操作してください。エディターから単一テストの実行やデバッグ、または上記の テストの実行 および テストのデバッグのように、テストの一部またはすべてを起動するための実行 / デバッグ構成を作成できます。

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