IntelliJ IDEA 2024.1 ヘルプ

実行 / デバッグ構成: Mocha

作成: 実行 | 実行構成の編集 | Add New Configuration | Mocha

このページでは、構成固有の項目と、すべての実行 / デバッグ構成に共通のオプションについて説明します。この構成の使用方法の詳細については、「Mocha」を参照してください。

このダイアログで、Mocha テストフレームワークを使用して JavaScript 単体テストを実行およびデバッグするための設定を作成します。

始める前に

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

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

Mocha 固有の構成設定

項目

説明

Node.js インタープリター

このフィールドには、使用する Node.js インタープリターを指定します。設定されたインタープリターの 1 つを選択するか、the Browse button をクリックし、ローカル Node.js インタープリターの構成の説明に従って新しく設定します。Project エイリアスを選択すると、IntelliJ IDEA は自動的に Node.js ページの Node インタープリターフィールドからプロジェクトのデフォルトインタープリターを使用します。

Node オプション

このフィールドに、Node.js 実行可能ファイルに渡す Node.js 固有のコマンドラインオプションを入力します。詳細については、Node パラメーターを参照してください。

作業ディレクトリ

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

環境変数

このフィールドで、必要に応じて Node.js 実行可能ファイルの環境変数(英語)を指定します。フィールドの右側にある参照 the Browse button をクリックし、環境変数ダイアログで変数のリストを構成します。次のように開きます。

  • 新しい変数を定義するには、the Add button をクリックして、変数の名前と値を指定します。

  • 変数定義を破棄するには、リストでそれを選択して the Remove button をクリックします。

  • 準備ができたら、OK をクリック

変数の定義は、環境変数読み取り専用フィールドにセミコロンを区切り文字として表示されます。例:

  • NODE_PATH : モジュール検索パスの前に付いたディレクトリの : -separated リスト。

  • NODE_MODULE_CONTEXTS : 独自のグローバルコンテキストでモジュールをロードするには 1 に設定します。

  • NODE_DISABLE_COLORS : REPL の色を無効にするには 1 に設定します。

Mocha パッケージ

このフィールドには、Mocha インストールホーム /npm/node_modules/mocha を指定してください。Node パッケージマネージャーを通じて Mocha を定期的にインストールした場合、IntelliJ IDEA は Mocha インストールホーム自体を検出します。あるいは、実行可能ファイルへのパスを手動で入力するか、参照 the Browse button をクリックしてダイアログで開く場所を選択します。

ユーザーインターフェース

このリストから、テストフォルダー内のテストが書き込まれるインターフェース(英語)を選択します。IntelliJ IDEA は、選択したインターフェースに準拠するテストのみを認識します。テストの実行中に IntelliJ IDEA が別のインターフェースのテストに対して実行されると、テストセッションはエラーでキャンセルされます。これは、指定されたテストフォルダー内のすべてのテストが同じインターフェースに従って書き込まれる必要があり、このインターフェースがリストから選択される必要があることを意味します。

追加 Mocha オプション

このフィールドでは、追加の Mocha コマンドラインオプション(英語)を指定します。例: --watch フラグを追加して、自動テストのようなランナーをオンにします。

その結果、現在の実行構成のテストは、再実行ボタン Rerun をクリックせずに、関連するソースコードを変更すると自動的に再開します。

テスト

この領域に、実行するテストを指定します。使用可能なオプションは次のとおりです。

  • ディレクトリ内すべて : フォルダーに保存されているファイルからすべてのテストを実行し、テストディレクトリフィールドにこのフォルダーへのパスを指定するには、このオプションを選択します。指定されたディレクトリのサブフォルダーでテストを探すには、サブディレクトリを含むチェックボックスを選択します。

  • ファイルパターン : このオプションを選択して、特定のマスクに一致する名前のすべてのファイルでテストを検索し、テストファイルのパターンフィールドでマスクを指定します(例: *.test.js)。

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

  • テストファイル : 1 つのファイルからテストのみを実行し、テストファイルフィールドにこのファイルへのパスを指定するには、このオプションを選択してください。

  • スイート : このオプションを選択して、テストファイルから個々のスイートを実行し、テストファイルフィールドにこのファイルへのパスを指定します。スイート名フィールドで the Browse button をクリックし、Add ボタンと Remove ボタンを使用して実行するスイートのリストを構成します。

  • テスト : このオプションを選択して、テストファイルから個々のテストを実行し、テストファイルフィールドにこのファイルへのパスを指定します。テスト名フィールドで the Browse button をクリックし、Add および Remove ボタンを使用して実行するテストのリストを構成します。

Docker コンテナーの設定

この読み取り専用フィールドには、ポートとボリュームのバインディングが表示されます。the Expand button をクリックして、コマンドプレビューを開きます。

Node.js with Docker: run/debug configuration, Docker container settings

Docker Compose

この領域では、Docker Compose に渡すコマンドとオプションを指定します。デフォルト設定を受け入れるか、「 the Expand button 」をクリックしてカスタム設定 (たとえば、--rm--service-ports などのカスタム Docker Compose フラグ) を指定します。詳細については、Docker オフィシャル Web サイト(英語)を参照してください。

コマンドプレビューを確認してください。

共通設定

実行構成を編集するとき(ただし実行構成テンプレートは編集しないとき)、次のオプションを指定できます。

項目

説明

名前

実行構成の名前を指定して、編集または実行時に他の構成の間ですばやく識別できるようにします。

複数のインスタンスを許可する

この実行構成の複数のインスタンスを並行して実行できるようにします。

デフォルトでは無効になっており、別のインスタンスがまだ実行されているときにこの構成を開始すると、IntelliJ IDEA は実行中のインスタンスを停止して別のインスタンスを開始することを提案します。これは、実行構成が多くのリソースを消費し、複数のインスタンスを実行する正当な理由がない場合に役立ちます。

プロジェクトファイルとして保存

実行構成設定を含むファイルを保存して、他のチームメンバーと共有します。デフォルトの場所は .idea/runConfigurations です。ただし、.idea ディレクトリを共有したくない場合は、プロジェクト内の他のディレクトリに構成を保存できます。

デフォルトでは無効になっており、IntelliJ IDEA は実行構成設定を .idea/workspace.xml に保存します。

ツールバー

実行 / デバッグ構成のツリー表示には、プロジェクトで使用可能な構成を管理したり、デフォルトの構成テンプレートを調整したりするのに役立つツールバーがあります。

項目

ショートカット

説明

the Add button

Alt+Insert

実行 / デバッグ構成を作成します。

the Remove button

Alt+Delete

選択した実行 / デバッグ構成を削除します。デフォルト設定は削除できません。

Copy

Ctrl+D

選択した実行 / デバッグ構成のコピーを作成します。デフォルト設定のコピーを作成してください。

Save configuration

このボタンは、一時構成を選択した場合にのみ表示されます。このボタンをクリックして、一時的な構成を永続的なものとして保存します。

Move into new folder / Create new folder

新しいフォルダーに移動 / 新しいフォルダーを作成します。実行 / デバッグ構成は、フォルダーに配置することでグループ化できます。

フォルダーを作成するには、カテゴリ内の設定を選択し、Folder をクリックしてフォルダー名を指定します。カテゴリだけにフォーカスがある場合は、空のフォルダーが作成されます。

次に、設定をフォルダー内、フォルダー間、フォルダー外に移動するには、ドラッグまたは Move Up ボタンと Move Down ボタンを使用します。

グループ化を解除するには、フォルダーを選択して Remove Configuration をクリックします。

Sort configurations

このボタンをクリックすると、設定がアルファベット順にソートされます。

起動前

この領域では、選択した実行 / デバッグ構成を開始する前に実行するタスクを指定できます。タスクは、リストに表示されている順序で実行されます。

項目

ショートカット

説明

the Add button

Alt+Insert

このアイコンをクリックして、以下の使用可能なタスクのいずれかを追加します。

  • Web ブラウザーの起動 : ブラウザーを起動するにはこのオプションを選択します。開いたダイアログで、ブラウザーの種類を選択し、開始 URL を入力します。また、ブラウザーを JavaScript デバッガーで起動するかどうかを指定します。

  • 外部ツールの実行 : 外部アプリケーションを実行することを選択します。開いたダイアログで、実行する 1 つまたは複数のアプリケーションを選択します。IntelliJ IDEA でまだ定義されていない場合は、定義を追加します。詳細については、「外部ツールおよび外部ツールの設定」を参照してください。

  • 別の構成を実行 : 別の実行 / デバッグ構成を実行することを選択し、それが完了するまで待ってから現在の構成を開始します。複数の構成を並行して実行する場合は、複合実行 / デバッグ構成を使用してください。

  • ビルド : 指定したモジュールをコンパイルする場合に選択します。ビルドモジュールコマンドが実行されます。

    コンパイル中にエラーが発生すると、IntelliJ IDEA は実行 / デバッグ構成を開始しようとしません。

  • プロジェクトのビルド : プロジェクト全体をコンパイルする場合に選択します。ビルドプロジェクトコマンドが実行されます。

    コンパイル中にエラーが発生すると、IntelliJ IDEA は実行 / デバッグ構成を開始しようとしません。

  • ビルド、エラーチェックなし : ビルドオプションと同じですが、IntelliJ IDEA はコンパイル結果に関係なく実行 / デバッグ構成を開始しようとします。

  • アーティファクトのビルド : このオプションを選択して、アーティファクトを作成します。開いたダイアログで、構築する必要のある 1 つまたは複数のアーティファクトを選択します。

  • Ant ターゲットの実行 : Ant ターゲットを実行するにはこのオプションを選択します。開いたダイアログで、実行するターゲットを選択します。

  • リモート外部ツールの実行 : リモート SSH 外部ツールを追加します

  • Grunt タスクの実行 : Grunt タスクを実行するには、このオプションを選択してください。

    表示される Grunt タスクダイアログで、必要なタスクが定義されている Gruntfile.js を指定し、実行するタスクを選択して、Grunt ツールに渡す引数を指定します。

    Node.js インタープリターの場所、渡すパラメーター、grunt-cli パッケージへのパスを指定します。

  • gulp タスクの実行 : Gulp タスクを実行するには、このオプションを選択してください。

    表示される Gulp タスクダイアログで、必要なタスクが定義されている Gulpfile.js を指定し、実行するタスクを選択して、Gulp ツールに渡す引数を指定します。

    Node.js インタープリターの場所、それに渡すパラメーター、gulp パッケージへのパスを指定します。

  • Maven ゴールの実行 : Maven ゴールを実行するには、このオプションを選択します。開いたダイアログで、実行するゴールを選択します。

  • npm スクリプトの実行 : npm スクリプトを実行するには、このオプションを選択してください。

    開いた NPM スクリプトダイアログで、npm 実行 / デバッグ構成設定を指定します。

  • TypeScript のコンパイル : 組み込み TypeScript コンパイラーを実行するように選択し、TypeScript コードに加えたすべての変更が生成された JavaScript ファイルに反映されるようにします。表示される TypeScript のコンパイル設定ダイアログで、エラーの確認チェックボックスを選択または選択解除して、エラーが検出された場合のコンパイラーの動作を設定します。

    • エラーの確認チェックボックスが選択されていると、コンパイラーはすべてのエラーを表示し、実行構成は開始されません。

    • エラーの確認チェックボックスがオフの場合、コンパイラーは検出されたすべてのエラーを表示しますが、実行構成は起動されます。

  • CoffeeScript ソースマップの生成 : CoffeeScript ソースのソースマップを生成するには、このオプションを選択してください。表示されるダイアログで、CoffeeScript のソースファイルがある場所を指定します。

  • Rake タスクの実行 : 実行またはデバッグの前に実行される Rake タスクを追加します。Rake タスクを選択するには、参照ボタン the Browse button をクリックして、使用可能なタスクのリストから目的のタスクを選択します。

    コード補完はこちらから入手できます。

    Code completion for the Rake tasks
  • JRuby コンパイラーの実行 : 指定されたターゲットパス、コンパイラープロセスヒープサイズ、コマンドラインパラメーター(存在する場合)を指定して JRuby コンパイラーを実行するには、このオプションを選択します。

the Remove button

Alt+Delete

このアイコンをクリックして、選択したタスクをリストから削除します。

Edit

Enter

選択したタスクを編集するには、このアイコンをクリックします。開いたダイアログで必要な変更を加えます。

Method up

Method down

Alt+Up

Alt+Down

これらのアイコンをクリックして、選択したタスクをリスト内で 1 行上または下に移動します。タスクは、リストに表示されている順に実行されます。

このページを表示する

実行 / デバッグ構成を実際に開始する前に、実行 / デバッグ構成設定を表示するには、このチェックボックスを選択します。

ツールウィンドウをアクティブにする

デフォルトではこのチェックボックスは選択されており、実行 / デバッグ構成を開始すると実行またはデバッグツールウィンドウが開きます。

それ以外の場合、チェックボックスがオフの場合、ツールウィンドウは非表示になります。ただし、構成が実行されている場合は、Alt+4 または Alt+5 を押すことにより、構成に対応するツールウィンドウを自分で開くことができます。

関連ページ:

Mocha

Mocha は、非同期テストシナリオの実行に特に役立つ JavaScript テストフレームワークです。IntelliJ IDEA の外部から Mocha テストを実行し、ツリービューに配置されたテスト結果を調べて、そこからテストソースに簡単に移動できます。テストの横にあるエディターで、IntelliJ IDEA はテストのステータスを表示し、テストをすばやく実行またはデバッグするオプションを示します。始める前に:Node.js をダウンロードしてインストールします。設定 | プラグインページのイ...

プラグインのインストール

プラグインは IntelliJ IDEA のコア機能を拡張します。例: プラグインをインストールして、次の機能を取得します。バージョン管理システム、課題追跡システム、ビルド管理サーバー、その他のツールとの統合。さまざまな言語とフレームワークのコーディング支援サポート。ショートカットのヒント、ライブプレビュー、ファイルウォッチャーなど。新しいプログラミング言語を学ぶのに役立つコーディング演習。プラグイン設定を開くを押して設定を開き、を選択します。マーケットプレースタブを使用して、JetBrains...

Node.js

Node.js は、サーバーやコマンドラインなど、ブラウザーの外部で JavaScript を実行するための軽量ランタイム環境です。IntelliJ IDEA は Node.js と統合されており、アプリケーションの構成、編集、実行、デバッグ、テスト、プロファイリング、保守を支援します。Node.js がアプリケーションのローカルランタイムとして、または npm パッケージの管理、JavaScript リンターの実行、ツールのビルド、フレームワークのテストなどにのみ必要な場合は、Node.js をイ...

Node.js

このページは、プラグインのインストールに従って、設定 | プラグインページのインストール済みタブで Node.js バンドルプラグインが有効になっている場合にのみ表示されます。Node.js の操作方法については、Node.js アプリケーションの開発セクションを参照してください。次の Node.js バージョンは、IntelliJ IDEA 2023.3 以降でサポートされています。Node.js 20 - アクティブな長期サポート (LTS) バージョン、Node.js 21 - 現在のバージョン...

実行 / デバッグ構成: Node.js

作成: 次の Node.js バージョンは、IntelliJ IDEA 2023.3 以降でサポートされています。Node.js 20 - アクティブな長期サポート (LTS) バージョン、Node.js 21 - 現在のバージョン、サポートされている Node.js バージョンの詳細を参照してください。このダイアログで、コンピューター上の Node.js アプリケーションと一緒にデバッガーを開始するための構成を作成します。始める前に:Node.js をダウンロードしてインストールします。JetB...

Node.js と Docker

Docker を使用すると、Node.js アプリケーションを IntelliJ IDEA から素早くブートストラップして実行、デバッグ、プロファイリングすることができます。IDE は、新しい Dockerfile を自動的に作成し、イメージをビルドして実行し、ソースコードを同期し、コンテナーに npm 依存関係をインストールすることで、初期構成を処理する WebStorm と Docker のクイックツアーでいくつかの例を見つけることができます。始める前に:設定 | プラグインページのインストール済み...