このガイドでは、同じマシン上の別のインスタンスとして実行しているデスクトップ版 Firefox に、Firefox 開発ツールを接続する方法を説明します。ここでは、デバッグされる Firefox のインスタンスをデバッグ先、デバッグを行う Firefox のインスタンスをデバッグ元と呼びます。
始めにデバッグ元とデバッグ先の 開発ツールのオプション で、"ブラウザーとアドオンのデバッガーを有効" および "リモートデバッガーを有効" を有効にしなければなりません。
この作業は 1 回だけ必要です。設定値は再起動後も維持されます。
次に、デバッグ先でデバッガーサーバーを開始します。
Firefox 37 より前のバージョンでは、開発ツールバー を開いて以下のコマンドを実行します:
listen 6000
このコマンドは、ポート 6000 番でデバッガークライアントの接続を待ち受けするよう、デバッグ先に指示します。6000 番以外も使用できます。
デバッグ先を再起動した場合は、再度コマンドを実行しなければなりません。
Firefox 37 以降でも前出の方法を使用できますが、もうひとつ方法があります。--start-debugger-server オプションを渡して、コマンドラインからデバッグ先を起動します:
/path/to/firefox --start-debugger-server
引数を渡さない場合、--start-debugger-server はデバッガーサーバーをポート 6000 番で待ち受けさせます。別のポートを使用する場合は、希望するポート番号を渡します:
/path/to/firefox --start-debugger-server 1234
注記: Windows では、start-debugger-server をハイフン 1 個で呼び出します:
firefox.exe -start-debugger-server 1234
注記: デフォルトではセキュリティ上の理由で、devtools.debugger.force-local を設定しています。外部のマシンから Firefox インスタンスのデバッグを行いたい場合はこの設定を変更してもかまいませんが、信頼済みのネットワークまたはどのマシンがアクセスできるかを厳しく制御するファイアウォール規則が設定された環境でのみ行ってください。
接続方法は 2 種類あります。接続画面を使用する方法と、WebIDE を使用する方法です。
デバッグ元のツール/ウェブ開発メニュー配下に、[接続...] という項目があります。この項目をクリックすると、以下のようなページが開きます:
デバッグ先に待ち受けさせているポート番号を入力して、"接続" をクリックします。すると、デバッグ先で接続確認を求めるダイアログが表示されるでしょう:
"OK" をクリックしてデバッグ元に戻ると、以下のようなページが表示されます:
デバッグ元で WebIDE を開くと、"ランタイムを選択" の中に "リモートランタイム" があります:
リモートランタイムを選択すると、ホスト名とポート番号を求められます。"localhost:6000"、またはデバッグ先で別のポート番号で待ち受けさせている場合はポート番号を指定します。
すると、警告ダイアログを表示します:
OK をクリックします。WebIDE が、メインプロセスに開発ツールを接続します。content タブに接続したい場合は、左側のメニューを開いてデバッグを行いたいタブを選択してください。
