説明
デベロッパー ツールによって [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 の概要をご覧ください。
マニフェスト
例
次のコードは、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
パラメータは次のようになります。(url: string) => void
-
文字列
-
onRequestFinished
chrome.devtools.network.onRequestFinished.addListener(
callback: function,
)
ネットワーク リクエストが完了し、すべてのリクエスト データが使用可能になったときに呼び出されます。