webRequest.RequestFilter

描述应用于 webRequest 事件的过滤器的对象。

类型

该参数值是一个对象。其包含以下属性:

urls

string 的数组(array)。一个匹配模式的数组。只有目标与给定模式匹配的请求才会触发监听器。只有使用 HTTP 或 HTTPS 发出的请求才会触发事件,其他与模式匹配的协议(如 data: 和 file:)则不会触发事件。view-source: 请求可能会根据其内部 URL 进行匹配。

types 可选

webRequest.ResourceType 的数组(array)。用于表示资源类型的列表(例如样式表、图像、脚本)。只有请求的资源类型是给定类型之一时,监听器才会被调用。

tabId 可选

integer。只有来自具有此 ID 的标签页的请求才会使得监听器被调用。

windowId 可选

integer。只有来自具有此 ID 的窗口的请求才会使得监听器被调用。

incognito 可选

boolean。若提供,则不匹配隐身状态(truefalse)的请求将被过滤。

浏览器兼容性

备注: 此 API 基于 Chromium 的 chrome.webRequest API。该文档衍生自 Chromium 代码中的 web_request.json