WebStorm 2026.1 Help

実行 / デバッグ構成: Karma

作成: 実行 | 実行構成の編集 | 新しい構成を追加| Karma

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

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

始める前に

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

  2. Karma テストランナーKarma で説明されている手順に従ってインストールしてください。

Karma 固有の構成設定

項目

説明

構成ファイル

このフィールドには、 Karma 設定ファイル(英語)の位置を指定します。 通常、ファイルには拡張子 .conf.js

Karma オプション

このフィールドでは、Karma に渡すコマンドラインオプションを指定して、 karma.conf.js 構成ファイルのデフォルト設定を上書きします。

例: ヘッドレス Chrome でテストを実行またはデバッグするには、 Karma オプション フィールドに --browsers ChromeHeadless と入力します。 詳細については、「ヘッドレス Chrome による自動テスト(英語) 」を参照してください。

使用可能なすべての CLI オプションを表示するには、 ターミナル Alt+F12karma start --help と入力します。

ノードランタイム

このフィールドでは、使用する Node.js ランタイムを指定します。

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

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

詳細については、「リモート Node.js ランタイムの構成」、「ローカル Node.js ランタイムの構成」、「Linux の Windows サブシステムで Node.js を使用する 」を参照してください。

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 Node パッケージマネージャーを通じて Karmaをインストールした場合、WebStorm が Karma のインストール先を自動検出します。

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

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

作業ディレクトリ

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

環境変数

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

テスト

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

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

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

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

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

共通設定

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

項目

説明

名前

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

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

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

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

ツールバー

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

項目

ショートカット

説明

追加ボタン

Alt+Insert

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

the Remove button

Alt+Delete

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

コピー

Ctrl+D

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

構成の保存

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

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

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

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

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

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

構成を並べ替え

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

起動前

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

項目

ショートカット

説明

追加ボタン

Alt+Insert

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

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

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

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

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

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

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

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

the Remove button

Alt+Delete

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

編集

Enter

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

メソッドアップ

メソッドダウン

Alt+Up

Alt+Down

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

このページを表示する

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

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

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

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

2026 年 6 月 8 日