declarativeNetRequest.Redirect
详细描述如何执行重定向,作为 RuleAction
的 redirect
属性。仅对重定向规则有效。
注意: 重定向操作不会重定向请求,并且当以下情况发生时,请求将照常继续。
- 操作不会更改请求。
- 重定向 URL 无效(例如,
redirect.regexSubstitution
的值不是有效的 URL)。
类型
此类型的值为对象。它们包含以下属性
extensionPath
可选-
一个
string
。相对于扩展目录的路径。应以 '/' 开头。只有当资源列在web_accessible_resources
中时,请求的发起者才能遵循重定向。 regexSubstitution
可选-
一个
string
。指定regexFilter
的规则的替换模式。URL 中的regexFilter
的第一个匹配项将被此模式替换。在regexSubstitution
中,反斜杠转义的数字(\1
到\9
)用于插入相应的捕获组。\0
指的是整个匹配文本。 transform
可选-
declarativeNetRequest.URLTransform
。要执行的 URL 变换。 url
可选-
一个
string
。重定向 URL。不允许重定向到 JavaScript URL。
示例扩展
浏览器兼容性
BCD 表格仅在启用 JavaScript 的浏览器中加载。