browser.devtools.network

説明

chrome.devtools.network API を使用して、デベロッパー ツールの [ネットワーク] パネルに表示されるネットワーク リクエストに関する情報を取得します。

ネットワーク リクエスト情報は、HTTP アーカイブ形式（HAR）で表されます。HAR の説明は、このドキュメントの対象外です。HAR v1.2 仕様をご覧ください。

HAR の観点から見ると、browser.devtools.network.getHAR() メソッドは HAR ログ全体を返しますが、browser.devtools.network.onRequestFinished イベントは HAR エントリをイベント コールバックの引数として提供します。

効率上の理由から、リクエストの内容は HAR の一部として提供されません。リクエストの getContent() メソッドを呼び出して、コンテンツを取得できます。

ページの読み込み後にデベロッパー ツール ウィンドウを開くと、getHAR() から返されるエントリの配列に一部のリクエストが含まれないことがあります。ページを再読み込みして、すべてのリクエストを取得します。通常、getHAR() によって返されるリクエストのリストは、[ネットワーク] パネルに表示されるリストと一致します。

デベロッパー ツール API の使用に関する一般的な概要については、デベロッパー ツール API の概要をご覧ください。

マニフェスト

この API を使用するには、次のキーをマニフェストで宣言する必要があります。

"devtools_page"

例

次のコードは、40 KB を超えるすべての画像の URL を読み込み時にログに記録します。

browser.devtools.network.onRequestFinished.addListener(
  function(request) {
    if (request.response.bodySize > 40*1024) {
      browser.devtools.inspectedWindow.eval(
          'console.log("Large image: " + unescape("' +
          escape(request.request.url) + '"))');
    }
  }
);

この API を試すには、chrome-extension-samples リポジトリから devtools API の例をインストールします。

型

Request

ドキュメント リソース（スクリプト、画像など）のネットワーク リクエストを表します。詳しくは、HAR の仕様をご覧ください。

プロパティ

  • getContent

    void

    レスポンス本文のコンテンツを返します。

    getContent 関数は次のようになります。 

    () => {...}

    • 戻り値

      Promise<object>

      Chrome 151 以降 Chrome 152 以降の browser.*

      リクエストの完了時にレスポンス本文を受け取る関数。

メソッド

getHAR()

browser.devtools.network.getHAR(): Promise<object>

既知のすべてのネットワーク リクエストを含む HAR ログを返します。

戻り値

  • Promise<object>

    Chrome 151 以降 Chrome 152 以降の browser.*

    リクエストの完了時に HAR ログを受け取る関数。

イベント

onNavigated

browser.devtools.network.onNavigated.addListener(
  callback: function,
)

検査対象のウィンドウが新しいページに移動したときに呼び出されます。

パラメータ

  • callback

    関数

    callback パラメータは次のようになります。 

    (url: string) => void

    • URL

      文字列

onRequestFinished

browser.devtools.network.onRequestFinished.addListener(
  callback: function,
)

ネットワーク リクエストが完了し、すべてのリクエスト データが利用可能になったときに呼び出されます。

パラメータ

  • callback

    関数

    callback パラメータは次のようになります。 

    (request: Request) => void