webRequest.RequestFilter

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

类型

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

urls

stringarray。一个 匹配模式 数组。侦听器将仅在目标与任何给定模式匹配的请求时被调用。仅使用 HTTP 或 HTTPS 发出的请求才会触发事件,模式匹配支持的其他协议(例如 data: 和 file:)不会触发事件。view-source: 请求可以根据其内部 URL 进行匹配。

types 可选

webRequest.ResourceTypearray。资源类型列表(例如,样式表、图像、脚本)。侦听器将仅在请求给定类型之一的资源时被调用。

tabId 可选

integer。侦听器将仅在来自由此 ID 标识的 tab 的请求时被调用。

windowId 可选

integer。侦听器将仅在来自由此 ID 标识的 window 的请求时被调用。

incognito 可选

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

浏览器兼容性

BCD 表仅在浏览器中加载

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