PyCharm 2026.3 Help

実行 / デバッグ構成: Karma

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

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

始める前

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

  2. Karma テストランナーを Karma の説明に従ってインストールします。

  3. 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 ランタイムを指定します。

プロジェクト エイリアスを選択すると、PyCharm は ノードランタイム フィールドがある JavaScript ランタイムページのプロジェクトのデフォルトインタープリターを自動的に使用します。 ほとんどの場合、PyCharm はプロジェクトのデフォルトランタイムを検出し、そのフィールドに自動で入力します。

別の構成済みのローカルインタープリターまたはリモートインタープリターを選択するか、 参照ボタン をクリックして新しいインタープリターを構成することもできます。

Node オプション

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

  • 実行中に CoffeeScript ファイルをオンザフライで JavaScript にコンパイルするには、 --require coffeescript/register を使用します。

    このモードでは、 coffeescript パッケージの一部である register.js ファイルがプロジェクト内に配置されている必要があります。 そのため、 CoffeeScript コンパイラーのインストールの説明に従って、 coffeescript パッケージがローカルにインストールされていることを確認してください。

  • Chrome デバッグプロトコル(英語)サポートには --inspect または --inspect-brk パラメーターを使用します。

Karma パッケージ

このフィールドでは、次のいずれかを指定します：

  • Karma インストールホーム /npm/node_modules/karma 。 Karma を通常通り Node パッケージマネージャー でインストールした場合、PyCharm は Karma のインストールホームを自動的に検出します。

  • node_modules/@angular/cli へのパス。

  • Nx(英語) を使用している場合は、 node_modules/nx へのパス。

作業ディレクトリ

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

環境変数

このフィールドには、オプションでコマンドを実行するための環境変数を指定します。

テスト

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

  • すべてのテスト：: karma.conf.js 構成ファイルからすべてのテストを実行するには、このオプションを選択してください。

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

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

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

共通設定

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

項目

説明

名前

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

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

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

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

ステップ実行タブ

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

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

  1. デバッグセッションを開始する実行/デバッグ構成を開き、 ステップ タブに切り替えます。

  2. 自動 スマートステップイン を抑止するには、 常にスマートステップインする チェックボックスをオフにします。

  3. ソースマップの ignoreList フィールドからスクリプトをスキップするには、 ソースマップで指定された既知のサードパーティスクリプトを無視する チェックボックスを選択します。

    以前の Chrome 固有のフィールド名 x_google_ignoreList は非推奨ですが、 ignoreList フィールドがない場合は引き続き認識されることがあります。 詳しくは ソースマップ仕様を参照してください。

  4. カスタムスクリプトへのステップインを抑止するには、 以下のパターンに一致する URL のスクリプトにステップインしない チェックボックスを選択し、下にあるそのようなスクリプトのデフォルトリストを展開します。 *、 ?、 **、 ! を使用します。

    ステップ実行タブ

パターン構文

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

  • アスタリスク * は、スラッシュ / を除く 0 個以上の文字に一致します。 この文字は、単一のパス部分内で使用します。

  • 疑問符 ? は、スラッシュ / を除くちょうど 1 文字に一致します。

  • 二重アスタリスク ** は、セグメント全体として 0 個以上のパスセグメントに一致します。 意味は位置によって異なります:

    • 最初の部分として使用すると、先頭の任意のシンボルに一致します。

    • 最後の部分として使用すると、末尾の任意のシンボルに一致します。

    • 中央では、1 つ以上の部分に一致します。 例: a/**/b は a/x/b および a/x/y/b に一致しますが、 a/b には一致しません。

  • 末尾の二重アスタリスク ** が最後のセグメントの末尾にある場合 (単独で完全なセグメントになっていない場合。例: foo** )、そのセグメントの後の任意のサフィックスに一致します。 例: foo** は foo、 foobar、 foo/bar に一致します。

  • 感嘆符 ! で始まるパターンは、指定されたパターンを否定し、リスト内でその前に追加されたパターンを変更します。 新しい独自のパターンは追加しません。

例 1 案２：例 1 (Example 1 ならこれでOK)

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

例 2

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

  1. 二重アスタリスク ** は、 node_modules セグメントの前の任意のパスに一致します。

  2. node_modules は URL 内の node_modules に一致します。

  3. 二重アスタリスク ** は、後続の任意のものに一致します。

その結果、パターン **/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

ツールバー

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

項目

ショートカット

説明

追加ボタン

Alt+Insert

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

削除ボタン

Alt+Delete

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

コピー

Ctrl+D

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

構成を保存

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

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

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

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

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

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

構成の並べ替え

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

起動前

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

項目

ショートカット

説明

追加ボタン

Alt+Insert

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

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

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

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

  • File Watchers を実行する ：このオプションを選択すると、PyCharm が現在アクティブなすべての 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 のコンパイル設定 ダイアログで、 エラーの確認 チェックボックスを選択または選択解除して、エラーが検出された場合のコンパイラーの動作を設定します。

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

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

  • データソースの接続を解除する: 実行 / デバッグ構成を実行する前にデータソースへの接続を中断する場合は、このオプションを選択します。

削除ボタン

Alt+Delete

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

編集

Enter

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

メソッドアップ

メソッドダウン

Alt+Up

Alt+Down

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

このページを表示する

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

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

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

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

ツールウィンドウにフォーカス

実行 / デバッグ構成を開始したときに、 実行または デバッグツールウィンドウに自動的にフォーカスを移動させるには、このチェックボックスを選択してください。

2026 年 10 月 30 日
実行 / デバッグ構成: Jest実行 / デバッグ構成: Mocha