実行 / デバッグ構成: NodeUnit

作成: 実行(U) | 実行構成の編集(E) | | NodeUnit

このダイアログで、 Node.js アプリケーションの単体テストを実行するための構成を作成します。

始める前に

Node.js をダウンロードしてインストールします。
設定 | プラグインページのインストール済みタブで、 JavaScript and TypeScript および Node.js に必要なプラグインが有効になっていることを確認します。詳細は、プラグインの管理を参照してください。
次のいずれかの方法で Nodeunit テストフレームワークをインストールします。
- フレームワークを https://github.com/caolan/nodeunit(英語) からダウンロードし、公式の指示に従ってインストールしてください。
- npm、pnpm、Yarn の説明に従って、 Node パッケージマネージャー (NPM) を使用して nodeunit パッケージをインストールします。

NodeUnit 固有の構成設定

項目	説明
Node runtime	このフィールドに、使用する Node.js ランタイムを指定します。プロジェクトエイリアスを選択すると、IntelliJ IDEA は JavaScript Runtime ページの Node runtime フィールドからプロジェクトの既定のインタープリターを自動で使用します。ほとんどの場合、IntelliJ IDEA はプロジェクトの既定のランタイムを検出し、フィールド自体に入力します。別の構成済みのローカルインタープリターまたはリモートインタープリターを選択するか、をクリックして新しいインタープリターを構成することもできます。
作業ディレクトリ	このフィールドには、テストを検索するフォルダーを指定します。これはプロジェクトのルートフォルダーまたは test フォルダーの親ディレクトリになります。手動でパスを入力するか、参照をクリックしてダイアログが開く場所を選択します。
環境変数	このフィールドでは、必要に応じて、Node.js 実行可能ファイルの環境変数を指定します。フィールドの右側にある参照をクリックし、表示される環境変数ダイアログで変数のリストを設定します。新しい変数を定義するには、をクリックして、変数の名前と値を指定します。変数定義を破棄するには、リストでそれを選択してをクリックします。準備ができたら、 OK をクリック変数の定義は、環境変数読み取り専用フィールドにセミコロンを区切りとして表示されます。例えば： `NODE_PATH`: モジュール検索パスの前に付いたディレクトリの `:`-separated リスト。 `NODE_MODULE_CONTEXTS`: 独自のグローバルコンテキストでモジュールをロードするには 1 に設定します。 `NODE_DISABLE_COLORS`: REPL の色を無効にするには 1 に設定します。
Nodeunit モジュール	このフィールドでは、 Nodeunit フレームワークのインストールフォルダーを指定します。パスを手動で入力するか、をクリックして、表示されるダイアログでフォルダーを選択します。
実行	このリストから、実行するテストの範囲を選択します。使用可能なオプションは以下のとおりです。ディレクトリ内のすべてのテストファイル: このオプションを選択して、フォルダー内のすべてのテストファイルを実行し、作業フォルダーに対するこのフォルダーの相対パスを指定します。テストファイル:: このオプションを選択して、特定のファイルからテストを実行し、作業ディレクトリに対するこのファイルへのパスを入力します。

共通設定

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

項目	説明
名前(N)	実行構成の名前を指定して、編集または実行時に他の構成の間ですばやく識別できるようにします。
複数のインスタンスを許可する(U)	この実行構成の複数のインスタンスを並行して実行できるようにします。デフォルトでは無効になっており、別のインスタンスがまだ実行されているときにこの構成を開始すると、IntelliJ IDEA は実行中のインスタンスを停止して別のインスタンスを開始することを提案します。これは、実行構成が多くのリソースを消費し、複数のインスタンスを実行する正当な理由がない場合に役立ちます。
プロジェクトファイルとして保存(S)	実行構成設定を含むファイルを保存して、他のチームメンバーと共有します。デフォルトの場所は .idea/runConfigurations です。ただし、 .idea ディレクトリを共有したくない場合は、プロジェクト内の他のディレクトリに構成を保存できます。デフォルトでは無効になっており、IntelliJ IDEA は実行構成設定を .idea/workspace.xml に保存します。

項目

説明

名前(N)

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

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

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

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

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

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

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

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

項目	ショートカット	説明
	`Alt+Insert`	実行 / デバッグ構成を作成します。
	`Alt+Delete`	選択した実行 / デバッグ構成を削除します。デフォルト設定は削除できません。
	`Ctrl+D`	選択した実行 / デバッグ構成のコピーを作成します。デフォルト設定のコピーを作成してください。
		このボタンは、一時構成を選択した場合にのみ表示されます。このボタンをクリックして、一時的な構成を永続的なものとして保存します。
		新しいフォルダーに移動 / 新しいフォルダーを作成します。実行 / デバッグ構成は、フォルダーに配置することでグループ化できます。フォルダーを作成するには、カテゴリ内の設定を選択し、をクリックしてフォルダー名を指定します。カテゴリだけにフォーカスがある場合は、空のフォルダーが作成されます。次に、設定をフォルダー内、フォルダー間、フォルダー外に移動するには、ドラッグまたはボタンとボタンを使用します。グループ化を解除するには、フォルダーを選択してをクリックします。
		このボタンをクリックすると、設定がアルファベット順にソートされます。

起動前

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

項目	ショートカット	説明
	`Alt+Insert`	このアイコンをクリックして、以下の使用可能なタスクのいずれかを追加します。 Web ブラウザーの起動: ブラウザーを起動するには、このオプションを選択します。開いたダイアログで、ブラウザーの種類を選択し、開始 URL を指定します。また、ブラウザーを JavaScript デバッガーで起動するかどうかを指定します。外部ツールの実行: 外部アプリケーションを実行することを選択します。開いたダイアログで、実行する 1 つまたは複数のアプリケーションを選択します。 IntelliJ IDEA でまだ定義されていない場合は、定義を追加します。詳細については、外部ツールと外部ツール設定を参照してください。別の構成を実行: 別の実行 / デバッグ構成を実行することを選択し、それが完了するまで待ってから現在の構成を開始します。複数の構成を並行して実行する場合は、複合実行 / デバッグ構成を使用してください。ビルド: 指定されたモジュールをコンパイルするために選択します。ビルドモジュールコマンドが実行されます。コンパイル中にエラーが発生すると、IntelliJ IDEA は実行 / デバッグ構成を開始しようとしません。プロジェクトのビルド: プロジェクト全体をコンパイルすることを選択します。ビルドプロジェクトコマンドが実行されます。コンパイル中にエラーが発生すると、IntelliJ IDEA は実行 / デバッグ構成を開始しようとしません。ビルド、エラーチェックなし: ビルドオプションと同じですが、IntelliJ IDEA はコンパイル結果に関係なく実行 / デバッグ構成を開始しようとします。アーティファクトのビルド: このオプションを選択して、アーティファクトを作成します。開いたダイアログで、構築する必要のある 1 つまたは複数のアーティファクトを選択します。リモート外部ツールの実行: リモート 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 タスクを選択するには、参照ボタンをクリックして、使用可能なタスクのリストから目的のタスクを選択します。コード補完はここから入手できることに注意してください。 JRuby コンパイラーの実行: 指定されたターゲットパス、コンパイラープロセスヒープサイズ、コマンドラインパラメーター（存在する場合）を指定して JRuby コンパイラーを実行するには、このオプションを選択します。
	`Alt+Delete`	このアイコンをクリックして、選択したタスクをリストから削除します。
	`Enter`	選択したタスクを編集するには、このアイコンをクリックします。開いたダイアログで必要な変更を加えます。
	`Alt+Up` `Alt+Down`	これらのアイコンをクリックして、選択したタスクをリスト内で 1 行上または下に移動します。タスクは、リストに表示されている順に実行されます。
このページを表示する		実行 / デバッグ構成を実際に開始する前に、実行 / デバッグ構成設定を表示するには、このチェックボックスを選択します。
ツールウィンドウをアクティブにする		デフォルトではこのチェックボックスは選択されており、実行 / デバッグ構成を開始すると実行またはデバッグツールウィンドウが開きます。それ以外の場合、チェックボックスがオフの場合、ツールウィンドウは非表示になります。ただし、構成が実行されている場合は、 `Alt+4` または `Alt+5` を押すことにより、構成に対応するツールウィンドウを自分で開くことができます。

2026 年 3 月 30 日