chrome.devtools.network

描述 使用 chrome.devtools.network API 获取开发者工具的网络面板中显示的与网络请求相关的信息。
可用版本 从 Chrome 18 开始支持。

有关使用开发者工具 API 的一般信息请参见开发者工具 API 概述

概述

网络请求信息以 HTTP 档案的格式(HAR)表示。有关 HAR 的详细解释超出了本文档的范围,请参见 HAR v1.2 规范(英文)。

就 HAR 而言,chrome.devtools.network.getHAR 方法返回整个 HAR 记录,而 chrome.devtools.network.onRequestFinished 事件提供 HAR 项,作为事件回调函数的参数。

注意,由于效率原因,请求的内容并没有包含在提供的 HAR 中,您可以调用请求的 getContent() 方法来获得内容。

如果开发者工具在页面加载完成后打开,getHAR() 返回的数组中可能会缺少一些请求。重新加载页面可以获得所有请求。大体上说,getHAR() 返回的请求列表与网络面板中显示的内容匹配。

例子

如下代码在加载时记录下所有大于 40KB 的图片:

      chrome.devtools.network.onRequestFinished.addListener(
          function(request) {
            if (request.response.bodySize > 40*1024)
            chrome.experimental.devtools.console.addMessage(
                chrome.experimental.devtools.console.Severity.Warning,
                "大图片:" + request.request.url);
      });
      

您可以在示例中找到使用这一 API 的更多例子。

摘要

类型
Request
方法
getHAR chrome.devtools.network.getHAR(function callback)
事件
onRequestFinished
onNavigated

类型

Request

代表某一文档资源的网络请求(脚本、图片等)。请参见 HAR 规范
方法

getContent

Request.getContent(function callback)

返回响应正文的内容。

参数
function callback

请求完成时接收响应正文的函数。

callback 参数应该是一个如下形式的函数:

function(string content, string encoding) {...};
string content

响应正文的内容(可能经过编码)。

string encoding

如果内容没有经过编码则为空,否则为编码的名称。当前只支持 base64 编码。

方法

getHAR

chrome.devtools.network.getHAR(function callback)

返回包含所有已知网络请求的 HAR 日志。

参数
function callback

请求完成时接收 HAR 日志的函数。

callback 参数应该是一个如下形式的函数:

function(object harLog) {...};
object harLog

HAR 日志,有关细节请参见 HAR 规范。

事件

onRequestFinished

当网络请求完成并且所有请求的数据都可用时产生。

addListener

chrome.devtools.network.onRequestFinished.addListener(function callback)
参数
function callback

callback 参数应该是一个如下形式的函数:

function( Request request) {...};
Request request

以 HAR 项的形式描述的网络请求,有关细节请参见 HAR 规范。

onNavigated

当审查的窗口导航到新页面时产生。

addListener

chrome.devtools.network.onNavigated.addListener(function callback)
参数
function callback

callback 参数应该是一个如下形式的函数:

function(string url) {...};
string url

新页面的 URL。

示例扩展程序

  • FirePHP for Chrome – Extends the Developer Tools, adding support for parsing FirePHP messages from server