実行 / デバッグ構成: Spy-js

作成: 実行 | 実行構成の編集 | | Spy-js

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

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

始める前に

Node.js をダウンロードしてインストールします。
プラグインのインストールに記載されている通り、設定 | プラグインページのインストール済みタブで Node.js バンドルプラグインが有効になっていることを確認してください。
JetBrains マーケットプレイスからプラグインをインストールするの説明に従って、設定 | プラグインページのマーケットプレースタブに Spy-js プラグインをインストールします。

Spy-js 固有の構成設定

項目	説明
ノードランタイム	このフィールドでは、使用する Node.js ランタイムを指定します。プロジェクトエイリアスを選択した場合、WebStorm は JavaScript Runtime ページのノードランタイムフィールドにあるプロジェクトのデフォルトインタープリターを自動的に使用します。ほとんどの場合、WebStorm はプロジェクトのデフォルトランタイムを検出し、自動的にフィールドに入力します。別の構成済みのローカルインタープリターまたはリモートインタープリターを選択するか、をクリックして新しいインタープリターを構成することもできます。詳細については、「リモート Node.js ランタイムの構成」、「ローカル Node.js ランタイムの構成」、「Linux の Windows サブシステムで Node.js を使用する」を参照してください。
トレースサーバーポート	このフィールドでは、 Spy-js がプロキシサーバーとして機能するポートを指定します。トレースサーバーポートは自動的に入力されます。ポートの競合を回避するために、推奨値を受け入れ、システムプロキシを自動的に構成するチェックボックスを選択したままにすることをお勧めします。その結果、指定したポート番号がシステムプロキシサーバーに自動的に設定されます。または、システムプロキシポートを手動で構成します。設定 \| Windows の設定 \| ネットワークとインターネット \| プロキシに移動し、プロキシサーバーを使用するをオンにします。ポートフィールドに、トレースサーバーのポート番号を入力します。 Microsoft オフィシャル Web サイトの詳細を参照してください。システム環境設定 \| ネットワークに移動し、拡張をクリックし、プロキシタブに切り替え、自動プロキシ設定をクリアして、プロキシ構成ファイルの URL アドレスを入力してください。 URL のポートが、実行 / デバッグ構成のトレースサーバーポートと同じであることを確認してください。 Apple 公式 Web サイト(英語)の詳細を参照してください。
使用	このフィールドでは、トレースセッションを構成する方法を指定します。 Spy-js に内部定義済み構成を適用させるには、デフォルトの構成を選択します。カスタムで手動で作成した設定を適用するには、構成ファイルオプションを選択し、カスタム設定ファイルの場所を下の構成フィールドに指定します。構成ファイルは、 Spy-js の設定要件(英語)に適合する有効な JavaScript コードを含む拡張子 .js または .conf.js の JavaScript ファイルです。 WebStorm がプロジェクト内で拡張子 .conf.js のファイルを検出すると、それらのファイルがリストに表示されます。構成ファイルへのパスを手動で入力するか、閲覧するをクリックして、表示されるダイアログで場所を選択します。指定すると、構成ファイルがリストに追加されるため、パスを指定する代わりに次回からリストから取得できます。
トレースする URL	このフィールドでは、イベントをキャプチャーする Web ページの URL アドレスを指定します。デフォルトでは、フィールドは空です。これは、 Spy-js が現在開いているすべての Web ページでイベントをキャプチャーすることを意味します。トレースを特定のページに制限する場合は、その URL アドレスを指定します。アドレスを手動で入力するか、構成で指定されている場合はリストから選択します。

共通設定

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

項目	説明
名前	実行構成の名前を指定して、編集または実行時に他の構成の間ですばやく識別できるようにします。
複数のインスタンスを許可する	この実行構成の複数のインスタンスを並列実行できるようにします。デフォルトでは無効になっており、他のインスタンスが実行中にこの構成を開始すると、WebStorm はそのインスタンスの停止と新しいインスタンスの開始を提案します。これは、実行構成が多くのリソースを消費し、複数のインスタンスを実行する正当な理由がない場合に役立ちます。
プロジェクトファイルとして保存	実行構成設定を含むファイルを保存して、他のチームメンバーと共有します。デフォルトの保存先は .idea/runConfigurations です。ただし、 .idea ディレクトリを共有したくない場合は、プロジェクト内の任意の他のディレクトリに構成を保存できます。デフォルトでは無効になっており、WebStorm は実行構成設定を .idea/workspace.xml に保存します。

項目

説明

名前

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

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

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

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

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

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

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

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

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

2026 年 6 月 8 日