declarativeNetRequest.Redirect

描述如何执行重定向的详细信息,作为 RuleActionredirect 属性。仅对重定向规则有效。

注意: 重定向操作本身不会重定向请求,当以下情况发生时,请求将照常继续:

  • 操作未更改请求。
  • 重定向 URL 无效(例如,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。

扩展程序示例

浏览器兼容性