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