GoLand 2026.1 Help

実行 / デバッグ構成: Mocha

作成: 実行 | 実行構成の編集 | 新規構成の追加| Mocha

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

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

始める前に

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

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

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

Mocha 固有の構成設定

項目

説明

ノードランタイム

このフィールドでは、使用する Node.js ランタイムを指定します。 設定済みのランタイムのいずれかを選択するか、 参照ボタン をクリックして新しいランタイムを設定します。 プロジェクト エイリアスを選択した場合、GoLand は ノードランタイム フィールドで指定されたプロジェクトのデフォルトインタープリターを自動的に使用します。

ノードオプション

このフィールドに、Node.js 実行可能ファイルに渡す Node.js 固有のコマンドラインオプションを入力します。

作業ディレクトリ

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

環境変数

このフィールドで、該当する場合は Node.js 実行可能ファイルの 環境変数を指定してください。 フィールドの右側にある 閲覧 参照ボタン をクリックし、表示される 環境変数 ダイアログで変数のリストを設定します:

  • 新しい変数を定義するには、 追加ボタン をクリックして、変数の名前と値を指定します。

  • 変数定義を破棄するには、リストでそれを選択して 削除ボタン をクリックします。

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

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

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

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

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

Mocha パッケージ

このフィールドには、Mocha インストールホーム /npm/node_modules/mocha を指定してください。 Mochaノードパッケージマネージャー で通常通りインストールした場合、GoLand は Mocha のインストール先を自動で検出します。 あるいは、実行可能ファイルへのパスを手動で入力するか、 閲覧 参照ボタン をクリックしてダイアログで開く場所を選択します。

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

このリストから、 テストフォルダー内のテストが記述されている インターフェースを選択します。 GoLand は、選択した インターフェースに準拠するテストのみ認識します。 テストの実行中に GoLand が他の インターフェースのテストを実行した場合、テストセッションはエラーでキャンセルされます。 これは、指定された テストフォルダー内のすべてのテストが同じ インターフェースで記述されている必要があり、この インターフェースをリストから選択する必要があることを意味します。

追加 Mocha オプション

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

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

テスト

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

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

  • ファイルパターン このオプションを選択すると、特定のパターンに一致する名前のすべてのファイル内でテストが検索されます。 テストファイルパターン フィールドで glob パターンを使ってマスクを指定してください。例えば:

    *.test.js

    テストを含むファイルが別のフォルダー (例: test ) に保存されている場合は、作業ディレクトリを基準としたパターンでこのフォルダーへのパスを指定します。

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

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

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

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

Docker コンテナーの設定

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

Node.js と Docker: 実行 / デバッグ構成、Docker コンテナー設定

Docker Compose

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

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

共通設定

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

項目

説明

命名

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

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

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

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

ツールバー

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

項目

ショートカット

説明

追加ボタン

Alt+Insert

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

削除ボタン

Alt+Delete

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

コピー

Ctrl+D

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

構成の保存

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

新しいフォルダーに移動 / 新しいフォルダーを作成

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

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

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

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

構成を並べ替え

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

起動前

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

項目

ショートカット

説明

追加ボタン

Alt+Insert

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

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

  • 外部ツールの実行: 外部アプリケーションを実行することを選択します。 開いたダイアログで、実行したい 1 つまたは複数のアプリケーションを選択します。 GoLand でまだ定義されていない場合は、その定義を追加してください。

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

  • ファイル監視の実行 :このオプションを選択すると、GoLand に現在アクティブなすべての File Watchers が適用されます。

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

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

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

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

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

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

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

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

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

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

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

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

  • Go コマンド: プログラムを実行する前に Go コマンドを実行することを選択します。 例: 生成する を実行して、コンパイル前にソースコードを生成できます。 Go コマンドの編集タスク ダイアログでは、自動補完を使用できます。 自動補完は、次のコマンド 生成vettest -i をサポートしています。 独自のコマンドを使用できます。

削除ボタン

Alt+Delete

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

編集

Enter

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

メソッドアップ

メソッドダウン

Alt+Up

Alt+Down

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

このページを表示する

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

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

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

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

2026 年 5 月 22 日