chrome.devtools.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() 返回的请求列表应与“网络”面板中显示的列表一致。

如需大致了解如何使用开发者工具 API，请参阅开发者工具 API 摘要。

清单

如需使用此 API，必须在清单中声明以下键。

"devtools_page"

示例

以下代码会在加载所有大于 40KB 的图片时记录其网址：

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 函数如下所示： 

    () => {...}

    • 返回

      Promise<object>

      Chrome 151 及更高版本

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

方法

getHAR()

chrome.devtools.network.getHAR(): Promise<object>

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

返回

  • Promise<object>

    Chrome 151 及更高版本

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

事件

onNavigated

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

当被检查的窗口导航到新网页时触发。

参数

  • callback

    函数

    callback 参数的格式如下： 

    (url: string) => void

    • 网址

      字符串

onRequestFinished

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

在网络请求完成且所有请求数据均可用时触发。

参数

  • callback

    函数

    callback 参数的格式如下： 

    (request: Request) => void