PhpStorm 2026.1 Help

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

作成: 実行 | 構成を編集 | 新規構成の追加​| Spy-js

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

始める前に

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

  2. プラグインのインストール に記載されている手順に従って、 設定 | プラグイン ページの インストール済み タブで Node.js バンドルプラグインが有効化されていることを確認してください。

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

Spy-js 固有の構成設定

項目

説明

ノードランタイム

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

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

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

トレースサーバーポート

このフィールドでは、 Spy-js がプロキシサーバーとして機能するポートを指定します。

トレースサーバーポートは自動的に入力されます。 ポートの競合を回避するために、推奨値を受け入れ、 システムプロキシを自動的に構成する チェックボックスを選択したままにすることをお勧めします。 その結果、指定したポート番号がシステムプロキシサーバーに自動的に設定されます。

または、システムプロキシポートを手動で構成します。

設定 | Windows の設定 | ネットワークとインターネット | プロキシ に移動し、 プロキシサーバーを使用する をオンにします。 ポート フィールドに、 トレースサーバーのポート番号を入力します。

Microsoft オフィシャル Web サイトの詳細を参照してください。

システム環境設定 | ネットワーク に移動し、 拡張設定 をクリックし、 プロキシ タブに切り替え、 自動プロキシ設定 をクリアして、プロキシ構成ファイルの URL アドレスを入力してください。 URL のポートが実行 / デバッグ構成の トレースサーバーポートと同じであることを確認してください。

Apple 公式 Web サイト(英語)の詳細を参照してください。

使用

このフィールドでは、トレースセッションを構成する方法を指定します。

  • Spy-js に内部定義済み構成を適用させるには、 デフォルトの構成 を選択します。

  • カスタムで手動で作成した設定を適用するには、 構成ファイル オプションを選択し、カスタム設定ファイルの場所を下の 構成 フィールドに指定します。

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

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

トレースする URL

このフィールドでは、イベントをキャプチャーする Web ページの URL アドレスを指定します。 デフォルトでは、フィールドは空です。 これは、 Spy-js が現在開いているすべての Web ページでイベントをキャプチャーすることを意味します。 トレースを特定のページに制限する場合は、その URL アドレスを指定します。 アドレスを手動で入力するか、構成で指定されている場合はリストから選択します。

共通設定

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

項目

説明

命名

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

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

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

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

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

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

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

ツールバー

実行 / デバッグ構成のツリービューには、プロジェクト で利用できる構成の管理や、デフォルトの構成テンプレートの調整に役立つツールバーがあります。

項目

ショートカット

説明

追加ボタン

Alt+Insert

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

削除ボタン

Alt+Delete

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

コピー

Ctrl+D

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

構成の保存

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

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

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

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

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

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

構成を並べ替え

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

起動前

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

項目

ショートカット

説明

追加ボタン

Alt+Insert

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

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

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

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

  • ファイル監視の実行 :PhpStorm に現在アクティブな 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 年 5 月 22 日