webRequest.ResourceType

此类型是一个字符串,表示在 Web 请求中获取资源的上下文。

它用于使用 webRequest API 筛选您侦听的请求。例如:您可以仅侦听图像的请求,或仅侦听脚本的请求。

类型

此类型的值为字符串。可能的值为

beacon

通过 Beacon API 发送的请求。

csp_report

发送到 report-uri 的请求,该请求在检测到违反策略的尝试时在 Content-Security-Policy 标头中给出。

font

@font-face CSS 规则加载的 Web 字体。

image

加载为图像呈现的资源,但支持该类型的浏览器上的 imageset 除外(请参阅下面的浏览器兼容性)。

imageset

<picture> 元素加载或在 <img> 元素的 srcset 属性中给出的图像。

main_frame

加载到选项卡中的顶级文档。

media

<video><audio> 元素加载的资源。

object

<object><embed> 元素加载的资源。

没有专用 object_subrequest 类型的浏览器(请参阅下面的浏览器兼容性)也会将插件发送的后续请求标记为 object

object_subrequest

插件发送的请求。

ping

发送到超链接的 ping 属性中给定的 URL 的请求,当遵循超链接时。

没有专用 beacon 类型的浏览器(请参阅下面的浏览器兼容性)也会将通过 Beacon API 发送的请求标记为 ping

script

加载以由 <script> 元素执行或在 Worker 中运行的代码。

speculative

在推测连接中,浏览器已确定很快可能会发出对 URI 的请求,因此它会立即启动 TCP 和/或 TLS 握手,以便在实际请求资源时能够更快地准备好。请注意,此类连接不提供有效的选项卡信息,因此请求详细信息(如 tabIdframeIdparentFrameId 等)不准确。

stylesheet

加载以描述文档表示形式的 CSS 样式表。

sub_frame

加载到 <iframe><frame> 元素中的文档。

web_manifest

为可以安装到主屏幕的网站加载的 Web 应用清单

websocket

通过 WebSocket API 启动与服务器连接的请求。

xml_dtd

为 XML 文档加载的 DTD

xmlhttprequest

XMLHttpRequest 对象或通过 Fetch API 发送的请求。

xslt

加载用于转换 XML 文档的 XSLT 样式表。

other

任何其他可用类型未涵盖的资源。

浏览器兼容性

BCD 表仅在浏览器中加载

注意:此 API 基于 Chromium 的 chrome.webRequest API。本文档源自 Chromium 代码中的 web_request.json