PyCharm 2026.1 Help

実行 / デバッグ構成: Mocha

作成: Run | Edit Configurations | 新規構成の追加| Mocha​

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

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

始める前

  1. お使いのコンピューターに Node.js(英語) がインストールされていることを確認してください。

  2. 設定 | プラグイン ページ、タブ インストール済み で、 JavaScript and TypeScript および Node.js の必須プラグインが有効になっていることを確認してください。 詳細については、 プラグインの管理を参照してください。

Mocha 固有の構成設定

項目

説明

ノードランタイム

このフィールドでは、使用する Node.js ランタイムを指定します。 設定済みのランタイムのいずれかを選択するか、 参照ボタン をクリックして ローカル Node.js ランタイムの構成の説明に従って新しいランタイムを設定します。 Project エイリアスを選択すると、PyCharm は JavaScript Runtimes ページの ノードランタイム フィールドからプロジェクトのデフォルトランタイムを自動的に使用します。

Node オプション

このフィールドに、Node.js 実行可能ファイルに渡される Node.js 固有のコマンドラインオプションを入力します。 詳細については、 Node パラメーターを参照してください。

作業ディレクトリ

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

環境変数

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

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

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

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

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

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

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

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

Mocha パッケージ

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

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

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

追加 Mocha オプション​

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

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

テスト

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

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

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

    *.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 ディレクトリを共有したくない場合は、プロジェクト内の他のディレクトリに構成を保存できます。

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

ツールバー

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

項目

ショートカット

説明

追加ボタン

Alt+Insert

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

削除ボタン

Alt+Delete

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

コピー

Ctrl+D

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

構成を保存

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

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

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

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

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

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

構成の並べ替え

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

起動前

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

項目

ショートカット

説明

追加ボタン

Alt+Insert

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

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

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

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

  • Run File Watchers :このオプションを選択すると、PyCharm が現在アクティブなすべての File Watchers を適用します。

  • Run Remote External Tool: リモート SSH 外部ツールを追加します。

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

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

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

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

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

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

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

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

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

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

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

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

削除ボタン

Alt+Delete

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

編集

Enter

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

メソッドアップ

メソッドダウン

Alt+Up

Alt+Down

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

Show this page

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

Activate tool window

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

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

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

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

2026 年 6 月 1 日