webRequest.ResourceType

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

它用于通过 webRequest API 过滤您要监听的请求。例如:您可以只监听图片请求,或只监听脚本请求。

类型

此类型的值是字符串。可能的值有:

beacon

通过 Beacon API 发送的请求。

csp_report

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

font

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

图片

作为图像渲染加载的资源,但排除 imageset(在支持该类型的浏览器中)(请参阅下方的浏览器兼容性)。

imageset

<picture> 元素加载的图像,或在 <img> 元素的 srcset 属性中提供的图像。

json

通过 import 语句加载的 JSON 模块。

main_frame

加载到标签页中的顶级文档。

媒体

<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 App Manifest

websocket

通过 WebSocket API 与服务器建立连接的请求。

xml_dtd

为 XML 文档加载的 DTDs

xmlhttprequest

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

xslt

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

其他

不属于任何其他可用类型的资源。

浏览器兼容性

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