chrome.devtools.network

Description

使用 chrome.devtools.network API 检索有关网络面板中开发者工具显示的网络请求的信息。

Manifest Keys

必须在清单中声明以下键才能使用此 API。 devtools_page

有关使用开发人员工具 API 的一般介绍，请参阅 DevTools API 摘要。

# Overview

网络请求信息以 HTTP 存档格式 (HAR) 表示。 HAR 的描述超出了本文档的范围，请参阅 HAR v1.2 Specification。

在 HAR 方面，chrome.devtools.network.getHAR() 方法返回整个 HAR 日志，而 chrome.devtools.network.onRequestFinished 事件提供 HAR 条目作为事件回调的参数。

请注意，出于效率原因，请求内容不作为 HAR 的一部分提供。您可以调用请求的 getContent() 方法来检索内容。

如果在页面加载后打开开发者工具窗口，则 getHAR() 返回的条目数组中可能缺少某些请求。重新加载页面以获取所有请求。通常，getHAR() 返回的请求列表应与“网络”面板中显示的匹配。

# Examples

以下代码在加载时记录所有大于 40KB 的图像的 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 的示例Samples。

Summary

• Types

  Request

• Methods

  getHAR

• Events

  onNavigated

  onRequestFinished

Types

Request

表示对文档资源（脚本、图像等）的网络请求。请参阅 HAR 规范以供参考。

PROPERTIES

• getContent

  function

  返回响应正文的内容。

  The getContent function looks like:

  (callback: function) => {...}

  • callback

    function

    The callback parameter looks like:

    (content: string, encoding: string) => void

    • content

      string

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

    • encoding

      string

      如果内容未编码，则为空，否则为编码名称。目前仅支持 base64。

Methods

getHAR

chrome.devtools.network.getHAR(
  callback: function,
)

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

PARAMETERS

• callback

  function

  The callback parameter looks like:

  (harLog: object) => void

  • harLog

    object

    一个 HAR 日志。有关详细信息，请参阅 HAR 规范。

Events

onNavigated

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

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

PARAMETERS

• callback

  function

  The callback parameter looks like:

  (url: string) => void

  • url

    string

onRequestFinished

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

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

PARAMETERS

• callback

  function

  The callback parameter looks like:

  (request: Request) => void

  • request

    Request

By.一粒技术服务.