chrome.devtools.network

説明

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

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

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

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

ページが読み込まれた後にデベロッパー ツール ウィンドウを開いた場合、getHAR() から返されるエントリの配列に一部のリクエストが欠落している可能性があります。すべてのリクエストを取得するには、ページを再読み込みしてください。一般に、getHAR() から返されるリクエストのリストは、[Network] パネルに表示されるリストと一致します。

Developer Tools API の一般的な概要については、DevTools API の概要をご覧ください。

マニフェスト

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

"devtools_page"

例

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

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

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

型

Request

ドキュメント リソース（スクリプト、画像など）に対するネットワーク リクエストを表します。参考として、HAR 仕様をご覧ください。

プロパティ

• getContent

  void

  レスポンス本文の内容を返します。

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

  (callback: function)=> {...}

  • callback

    機能

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

    (content: string,encoding: string)=>void

    • を積極的に紹介

      文字列

      レスポンス本文のコンテンツ（エンコードされる可能性がある）。

    • encoding

      文字列

      コンテンツがエンコードされていない場合は空、それ以外の場合はエンコード名。現在サポートされているのは base64 のみです。

Methods

getHAR()

chrome.devtools.network.getHAR(
  callback: function,
)

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

パラメータ

• callback

  機能

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

  (harLog: object)=>void

  • harLog

    オブジェクト

    HAR ログ。詳しくは、HAR 仕様をご覧ください。

イベント

onNavigated

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

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

パラメータ

• callback

  機能

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

  (url: string)=>void

  • URL

    文字列

onRequestFinished

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

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

パラメータ

• callback

  機能

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

  (request: Request)=>void

  • request

    リクエスト