webRequest.RequestFilter

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

类型

此类型的值是对象。它们包含以下属性:

URLs

array of string。一个包含 匹配模式 的数组。监听器将仅为目标匹配任何给定模式的请求调用。只有使用 HTTP 或 HTTPS 发出的请求才会触发事件,模式匹配支持的其他协议(如 data: 和 file:)不会触发事件。view-source: 请求可以根据其内部 URL 进行匹配。

types 可选

array of webRequest.ResourceType。一个资源类型列表(例如,样式表、图像、脚本)。监听器将仅为请求这些给定类型之一的资源时调用。

tabId 可选

integer。监听器将仅为 ID 为此的 tab 发出的请求调用。

windowId 可选

integer。监听器将仅为 ID 为此的 window 发出的请求调用。

incognito 可选

boolean。如果提供,则会过滤掉不匹配隐私浏览状态(truefalse)的请求。

浏览器兼容性

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