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
。若提供,则不匹配隐身状态(true
或false
)的请求将被过滤。
浏览器兼容性
备注:
此 API 基于 Chromium 的 chrome.webRequest
API。该文档衍生自 Chromium 代码中的 web_request.json
。