実行 / デバッグ構成: Karma

作成: 実行 | 実行構成の編集 | | Karma

このダイアログで、 Karma テストランナーを使用して JavaScript 単体テストを実行およびデバッグするための設定を作成します。

始める前に

Node.js をダウンロードしてインストールします。
Karma テストランナーを Karma の説明に従ってインストールします。
Karma プラグインを設定 | プラグインにインストールします。手順については JetBrains Marketplace からプラグインをインストールするを参照してください。

Karma 固有の構成設定

項目	説明
構成ファイル	このフィールドには、 Karma 設定ファイル(英語)の位置を指定します。通常、ファイルには拡張子 .conf.js
Karma オプション	このフィールドでは、Karma に渡すコマンドラインオプションを指定して、 karma.conf.js 構成ファイルのデフォルト設定を上書きします。例: ヘッドレス Chrome でテストを実行またはデバッグするには、 Karma オプションフィールドに `--browsers ChromeHeadless` と入力します。詳細については、「ヘッドレス Chrome による自動テスト(英語) 」を参照してください。使用可能なすべての CLI オプションを表示するには、ターミナル `Alt+F12` に `karma start --help` と入力します。
ノードランタイム	このフィールドでは、使用する Node.js ランタイムを指定します。プロジェクトエイリアスを選択した場合、GoLand はノードランタイムフィールドからプロジェクトのデフォルトインタープリターを自動的に使用します。ほとんどの場合、GoLand はプロジェクトのデフォルトランタイムを検出し、そのフィールドに自動で入力します。別の構成済みローカルインタープリターを選択するか、をクリックして新しいものを構成することもできます。
ノードオプション	このフィールドに、Node.js 実行可能ファイルに渡す Node.js 固有のコマンドラインオプションを入力します。実行中に CoffeeScript ファイルをオンザフライで JavaScript にコンパイルするには、 `--require coffeescript/register` を使用します。このモードでは、 `coffeescript` パッケージの一部である register.js ファイルがプロジェクト内にある必要があります。 Chrome デバッグプロトコル(英語)サポートには `--inspect` または `--inspect-brk` パラメーターを使用します。
Karma パッケージ	このフィールドでは、次のいずれかを指定します： Karma インストールホーム /npm/node_modules/karma 。ノードパッケージマネージャーで Karmaを通常どおりインストールした場合、GoLandがKarmaインストールホームを自動検出します。 `node_modules/@angular/cli` へのパス。 Nx(英語) を使用している場合は、 `node_modules/nx` へのパス。
作業ディレクトリ	このフィールドでは、アプリケーションの作業ディレクトリを指定します。デフォルトでは、作業ディレクトリフィールドにはプロジェクトのルートフォルダーが表示されます。この定義済みの設定を変更するには、目的のフォルダーへのパスを指定します。
環境変数	このフィールドには、オプションでコマンドを実行するための環境変数を指定します。
テスト	この領域に、実行するテストを指定します。使用可能なオプションは以下のとおりです：すべてのテスト：: karma.conf.js 構成ファイルからすべてのテストを実行するには、このオプションを選択してください。テストファイル：: 1 つのファイルからテストのみを実行し、テストファイルフィールドにこのファイルへのパスを指定するには、このオプションを選択してください。スイート：: このオプションを選択して、テストファイルから個々のスイートを実行し、テストファイルフィールドにこのファイルへのパスを指定します。スイート名フィールドでをクリックし、ボタンとボタンを使用して実行するスイートのリストを構成します。テスト：: このオプションを選択して、テストファイルから個々のテストを実行し、テストファイルフィールドにこのファイルへのパスを指定します。テスト名フィールドでをクリックし、およびボタンを使用して実行するテストのリストを構成します。

共通設定

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

項目	説明
命名	実行構成の名前を指定して、編集または実行時に他の構成の間ですばやく識別できるようにします。
プロジェクトファイルとして保存	実行構成設定を含むファイルを保存して、他のチームメンバーと共有します。デフォルトの場所は .idea/runConfigurations です。ただし、 .idea ディレクトリを共有したくない場合は、プロジェクト内の他のディレクトリに構成を保存できます。デフォルトでは無効になっており、GoLand は実行構成設定を .idea/workspace.xml に保存します。

項目

説明

命名

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

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

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

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

ステップ実行タブ

このタブで、ステップ実行オプションを指定します。

ステップインでは、通常デバッグする必要がない可能性があるため、一部のスクリプトがスキップされます。このリストは、設定ダイアログ (Ctrl+Alt+S) のビルド、実行、デプロイ | デバッガー | ステップ実行中ページで微調整できます。

デバッグセッションの起動に使用する実行/デバッグ構成を開き、ステップ実行中タブに切り替えます。
自動スマートステップインを抑制するには、常にスマートステップインするチェックボックスをオフにします。
ソースマップの ignoreList フィールドからスクリプトをスキップするには、ソースマップで指定された既知のサードパーティスクリプトを無視するチェックボックスを選択します。
古い Chrome 固有のフィールド名 x_google_ignoreList は非推奨ですが、 ignoreList フィールドがない場合は引き続き認識されることがあります。詳しくは、ソースマップ仕様を参照してください。
カスタムスクリプトへのステップインを抑制するには、以下のパターンに一致する URL を持つスクリプトにステップインしないチェックボックスを選択し、下のそのようなスクリプトのデフォルトリストを展開します。 *、 ?、 **、 ! を使用します。

パターン構文

パターンでは次の文字がサポートされています:

アスタリスク * は、スラッシュ / を除く 0 個以上の文字に一致します。この文字は単一のパス部分内で使用します。
疑問符 ? は、スラッシュ / を除くちょうど 1 文字に一致します。
セグメント全体としての二重アスタリスク ** は、0 個以上のパスセグメントに一致します。意味は位置によって異なります:
- 最初の部分として使用すると、先頭の任意のシンボルに一致します。
- 最後の部分として使用すると、末尾の任意のシンボルに一致します。
- 中央では、1 つ以上の部分に一致します。たとえば、 a/**/b は a/x/b と a/x/y/b に一致しますが、 a/b には一致しません。
最後のセグメント末尾の二重アスタリスク ** (単独で完全なセグメントではないもの。たとえば foo**) は、そのセグメントの後の任意のサフィックスに一致します。たとえば、 foo** は foo、 foobar、 foo/bar に一致します。
感嘆符 ! で始まるパターンは、指定されたパターンを否定し、リスト内でその前に追加されたパターンを変更します。それ自体で新しいパターンを追加することはありません。

例 1

パターンリスト ["**/*.ts", "!**/*.test.ts"] では、最初の glob がすべての .ts ファイルに一致します。 2 番目のパターンは最初の glob を変更し、すべての .test.ts ファイルを一致から除外します。

例 2

渡された URL は、スラッシュ / によって部分に分割されます。したがって、 **/node_modules/** は次のように分割されます::

二重アスタリスク ** は、 node_modules セグメントより前の任意のパスに一致します。
node_modules は URL 内の node_modules に一致します。
二重アスタリスク ** は、その後に続く任意のものに一致します。

その結果、パターン **/node_modules/** は node_modules を含む任意の URL に一致します。

スクリプトの URL はパターン全体に対して照合されることに注意してください。 2 番目の二重アスタリスク ** を削除すると、パターンは node_modules で終わる任意の URL に一致しますが、そのような URL はおそらく 0 個です。

例 3

特定のファイル名で終わる任意のパターンに一致させるには、2 番目の二重アスタリスク ** を省略します。

**/app.js は app.js で終わるすべての URL に一致します。
次のパターンリストは、 node_modules 内で app.js という名前のものを除くすべてのスクリプトを無視します。
**/node_modules/** !**/app.js

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

項目	ショートカット	説明
	`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 generate` を実行して、コンパイル前にソースコードを生成できます。 Go コマンドの編集タスクダイアログでは、自動補完を使用できます。自動補完は、次のコマンド `generate`、 `vet`、 `test -i` をサポートしています。独自のコマンドを使用できます。
	`Alt+Delete`	このアイコンをクリックして、選択したタスクをリストから削除します。
	`Enter`	選択したタスクを編集するには、このアイコンをクリックします。開いたダイアログで必要な変更を加えます。
	`Alt+Up` `Alt+Down`	これらのアイコンをクリックして、選択したタスクをリスト内で 1 行上または下に移動します。タスクは、リストに表示されている順に実行されます。
このページを表示する		実行 / デバッグ構成を実際に開始する前に、実行 / デバッグ構成設定を表示するには、このチェックボックスを選択します。
ツールウィンドウをアクティブにする		デフォルトではこのチェックボックスは選択されており、実行 / デバッグ構成を開始すると実行またはデバッグツールウィンドウが開きます。それ以外の場合、チェックボックスがオフの場合、ツールウィンドウは非表示になります。ただし、構成が実行されている場合は、 `Alt+4` または `Alt+5` を押すことにより、構成に対応するツールウィンドウを自分で開くことができます。

2026 年 11 月 6 日