PyCharm 2025.3 ヘルプ

実行 / デバッグ構成: Spy-js (Node.js)

作成: 実行 | 実行構成の編集 | Add New Configuration | Spy-js (Node.js)

このダイアログで、Spy-js ツールを使用して Node.js アプリケーションをトレースするための構成を作成します。

始める前に

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

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

Node.js 固有の設定のための Spy-js

項目

説明

ノードランタイム

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

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

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

Spy-js では、Node.js バージョン 0.10.24 以降を使用することをお勧めします。

ECMAScript 6(英語) スクリプトのトレースを有効にするには、Node.js のバージョン 0.11.13 以降を使用し、Node パラメーターとして --harmony を指定します。

Node パラメーター

このフィールドに、Node.js 実行可能ファイルに渡される Node.js 固有のコマンドラインオプションを入力します。例: ECMAScript 6(英語) スクリプトのトレースを有効にするには、--harmony をノードパラメーターとして指定します。Node.js はバージョン 0.11.13 以降でなければならないことに注意してください。

作業ディレクトリ

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

JavaScript ファイル

このフィールドには、それを開始するアプリケーションのメインファイルへのパスを指定します(たとえば、Express(英語) アプリケーションの場合は bin/www)。

CoffeeScript をトレースする場合は、生成された JavaScript ファイルへのパスを指定します。ファイルは外部で生成することも、ファイルウォッチャーを使用したコンパイルを通じて生成することもできます。詳細については、CoffeeScript のデバッグを参照してください。

アプリケーションパラメーター

このフィールドに、起動時に process.argv(英語) 配列を介してアプリケーションに渡される Node.js 固有の引数を入力します。

環境変数

このフィールドで、必要に応じて Node.js 実行可能ファイルの環境変数(英語)を指定します。フィールドの右側にある参照 the Browse button をクリックし、環境変数ダイアログで変数のリストを構成します。次のように開きます。

  • 新しい変数を定義するには、the Add button をクリックして、変数の名前と値を指定します。

  • 変数定義を破棄するには、リストでそれを選択して the Remove button をクリックします。

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

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

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

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

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

構成ファイル

このリストから、構成設定を含むファイルを選択して、トレースセッションに適用します。

構成ファイルは、Spy-js の設定要件(英語)に適合する有効な JavaScript コードを含む拡張子 .js または .conf.js の JavaScript ファイルです。PyCharm がプロジェクトで拡張子 .conf.js のファイルを検出すると、これらのファイルがリストに表示されます。

構成ファイルへのパスを手動で入力するか、参照 the Browse button をクリックして、表示されるダイアログで場所を選択します。指定すると、構成ファイルがリストに追加されるため、パスを指定する代わりに次回からリストから取得できます。

共通設定

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

項目

説明

名前

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

複数のインスタンスを許可する

この実行構成の複数のインスタンスを並行して実行できるようにします。

デフォルトでは無効になっており、別のインスタンスがまだ実行されているときにこの構成を開始すると、PyCharm は実行中のインスタンスを停止して別のインスタンスを開始することを提案します。これは、実行構成が多くのリソースを消費し、複数のインスタンスを実行する正当な理由がない場合に役立ちます。

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

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

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

ツールバー

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

項目

ショートカット

説明

the Add button

Alt+Insert

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

the Remove button

Alt+Delete

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

Copy

Ctrl+D

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

Save configuration

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

Move into new folder / Create new folder

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

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

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

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

Sort configurations

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

起動前

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

項目

ショートカット

説明

the Add button

Alt+Insert

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

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

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

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

  • ファイル監視の実行 : 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 のコンパイル設定ダイアログで、エラーの確認チェックボックスを選択または選択解除して、エラーが検出された場合のコンパイラーの動作を設定します。

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

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

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

the Remove button

Alt+Delete

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

Edit

Enter

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

Method up

Method down

Alt+Up

Alt+Down

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

このページを表示する

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

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

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

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

2025 年 10 月 23 日

関連ページ:

プラグインのインストール

プラグインは PyCharm のコア機能を拡張します。例: プラグインをインストールして、次の機能を取得します。バージョン管理システム、課題追跡システム、ビルド管理サーバー、その他のツールとの統合。さまざまな言語とフレームワークのコーディング支援サポート。ショートカットのヒント、ライブプレビュー、ファイルウォッチャーなど。新しいプログラミング言語を学ぶのに役立つコーディング演習。プラグイン設定を開くを押して設定を開き、を選択します。マーケットプレースタブを使用して、JetBrains マーケット...

JavaScript ランタイム

推奨ランタイム:このエリアでは、使用するランタイムを選択します。利用可能なランタイムのセットは、インストールされているプラグインによって異なります。パッケージマネージャー:このフィールドでは、現在のプロジェクトのパッケージマネージャー (npm、Yarn、pnpm、bun) を選択します。PyCharm は、これらのマネージャーへの現在のシステムパスに、、エイリアスを使用します。カスタムインストールを使用するには、選択をクリックし、関連するパッケージマネージャーのインストールフォルダーを選択...

CoffeeScript

PyCharm では、JavaScript にコンパイルされる CoffeeScript を使用できます。PyCharm は *.coffee ファイルを認識し、それらにのマークを付けます。CoffeeScript コードにブレークポイントを直接設定でき、PyCharm はコンパイル中に生成されたソースマップを使用してブレークポイントを認識します。PyCharm は、キーワード、ラベル、変数、パラメーター、関数の補完を提案することにより、CoffeeScript コードの作成を支援します。シンボルから宣...

実行 / デバッグ構成

PyCharm は、実行 / デバッグ構成を使用して、コードを実行、デバッグ、テストします。各構成は、何を実行し、どのパラメーターと環境を使用するかを定義する、名前付きのスタートアッププロパティのセットです。さまざまな起動プロパティを使用して、PyCharm がスクリプトを実行するために使用するさまざまな方法を定義できます。例: 異なる Python インタープリターを使用して同じコードを実行し、さまざまな環境変数のセットを提供し、代替ファイルから入力値を取得できます。実行 / デバッグ構成には...

外部ツール

サードパーティのコマンドラインアプリケーションを外部ツールとして構成し、PyCharm から実行します。たとえば、ワークフローによっては、特定のスクリプト、コードジェネレーター、アナライザー、プリプロセッサーまたはポストプロセッサー、データベースユーティリティなどを実行する必要がある場合があります。PyCharm を外部ツールとして設定すると、専用のアクションが提供されます。このアクションは、メインメニューや特定のコンテキストメニューから実行したり、ショートカットを割り当てたり、特定の実行構成の...

外部ツール

このページでは、ローカル外部ツールに対して構成できる設定について説明します。外部ツールの追加と使用の詳細については、「外部ツール」を参照してください。ツールバーのボタンを使って、利用可能な外部ツールのリストを管理します。メニューに表示せずに残しておきたいツールのチェックボックスをオフにします。追加新しい外部ツールを追加します。除去選択したツールまたはグループを削除します。編集選択したツールを編集します。上へ選択したツールをリスト内で上に移動します。