This page was saved using WebZIP 7.0.3.1030 offline browser on 12/24/13 11:31:36.
Address: https://crxdoc-zh.appspot.com/extensions/devtools.network.html
Title: chrome.devtools.network - Google Chrome 扩展程序开发文档（非官方中文版）  •  Size: 30151

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 的更多例子。

chrome.devtools.network 参考

类型

Request

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

Request 的方法

getContent

Request.getContent(function callback)

返回响应正文的内容。

参数

callback ( function )

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

callback 参数应该指定一个如下形式的函数： 

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

content ( string )

响应正文的内容（可能经过编码）。

encoding ( string )

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

方法

getHAR

chrome.devtools.network.getHAR(function callback)

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

参数

callback ( function )

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

callback 参数应该指定一个如下形式的函数： 

function(object harLog) {...};

harLog ( object )

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

事件

onRequestFinished

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

addListener

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

参数

callback ( function )

callback 参数应该指定一个如下形式的函数： 

function(Request request) {...};

request ( Request )

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

onNavigated

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

addListener

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

参数

callback ( function )

callback 参数应该指定一个如下形式的函数： 

function(string url) {...};

url ( string )

新页面的 URL。