説明
chrome.devtools.network API を使用すると、[ネットワーク] パネルのデベロッパー ツールに表示されるネットワーク リクエストに関する情報を取得できます。
マニフェスト
デベロッパー ツール API の使用方法の概要については、デベロッパー ツール API の概要をご覧ください。
概要
ネットワーク リクエスト情報は、HTTP アーカイブ形式（ HAR）で表されます。HAR の説明は、このドキュメントのスコープ外です。HAR v1.2 仕様をご覧ください。
HAR の観点から見ると、chrome.devtools.network.getHAR() メソッドは HAR ログ全体を返しますが、
chrome.devtools.network.onRequestFinished イベントはイベント
コールバックの引数として HAR エントリを提供します。
効率上の理由から、リクエスト コンテンツは HAR の一部として提供されません。リクエストの getContent() メソッドを呼び出してコンテンツを取得できます。
ページの読み込み後にデベロッパー ツール ウィンドウが開いている場合、getHAR() から返されるエントリの配列に一部のリクエストが含まれていないことがあります。ページを再読み込みして、すべてのリクエストを取得してください。通常、getHAR() から返されるリクエストのリストは、[ネットワーク] パネルに表示されるリクエストのリストと一致します。
例
次のコードは、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 を試すには、devtools API のサンプルを chrome-extension-samples リポジトリからインストールします。
型
Request
ドキュメント リソース（スクリプト、画像など）のネットワーク リクエストを表します。リファレンスについては、HAR 仕様をご覧ください。
プロパティ
-
getContent
void
Promiseレスポンス本文のコンテンツを返します。
getContent関数の例を次に示します。(callback?: function) => {...}
-
callback
関数（省略可）
callbackパラメータの例を次に示します:(response: object) => void
-
レスポンス
オブジェクト
保留中レスポンス本文とそのエンコードを含むオブジェクト。
-
コンテンツ
文字列
レスポンス本文のコンテンツ（エンコードされている可能性があります）。
-
encoding
文字列
コンテンツがエンコードされていない場合は空、それ以外の場合はエンコード名。現時点でサポートされているのは base64 のみです。
-
-
-
戻り値
Promise<object>
保留中リクエストが完了したときにレスポンス本文を受け取る関数。
Promise は Manifest V3 以降でのみサポートされています。他のプラットフォームではコールバックを使用する必要があります。
-
メソッド
getHAR()
chrome.devtools.network.getHAR(
callback?: function,
): Promise<object>
既知のすべてのネットワーク リクエストを含む HAR ログを返します。
パラメータ
-
callback
関数（省略可）
callbackパラメータの例を次に示します:(harLog: object) => void
-
harLog
オブジェクト
HAR ログ。詳細については、HAR 仕様をご覧ください。
-
戻り値
-
Promise<object>
保留中リクエストが完了したときに HAR ログを受け取る関数。
Promise は Manifest V3 以降でのみサポートされています。他のプラットフォームではコールバックを使用する必要があります。
イベント
onNavigated
chrome.devtools.network.onNavigated.addListener(
callback: function,
)
検査対象のウィンドウが新しいページに移動したときに発生します。
パラメータ
-
関数
callbackパラメータの例を次に示します:(url: string) => void
-
文字列
-
onRequestFinished
chrome.devtools.network.onRequestFinished.addListener(
callback: function,
)
ネットワーク リクエストが完了し、すべてのリクエスト データが利用可能になったときに発生します。