declarativeNetRequest.URLTransform

描述要对重定向规则执行的 URL 转换的详细信息。此对象可以在 rule.action.redirect.transform 中指定。

类型

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

fragment 可选

一个 string。请求的新片段。应为空,在这种情况下将清除现有片段;或者应以 '#' 开头。

host 可选

一个 string。请求的新主机名。

password 可选

一个 string。请求的新密码。

path 可选

一个 string。请求的新路径。如果为空,则清除现有路径。

port 可选

一个 string。请求的新端口。如果为空,则清除现有端口。

query 可选

一个 string。请求的新查询。应为空,在这种情况下将清除现有查询;或者应以 '?' 开头。

queryTransform 可选

一个描述如何添加、删除或替换查询键值对的对象。如果指定了 'query',则不能指定。

addOrReplaceParams 可选

一个描述要添加或替换的查询键值对列表的对象数组。

key

一个 string。键值。

replaceOnly 可选

一个 boolean。如果为 true,则仅当查询键已存在时才替换它。否则,如果缺少键,则还会添加它。默认为 false。

value

一个 string。值值。

removeParams 可选

一个 string 数组。要删除的查询键列表。

scheme 可选

一个 string。请求的新方案。允许的值为 "http""https" 以及扩展程序的方案,例如 Firefox 中的 "moz-extension" 或 Chrome 中的 "chrome-extension"。当使用扩展程序方案时,必须指定 host 以生成有意义的重定向目标。

username 可选

一个 string。请求的新用户名。

浏览器兼容性

BCD 表仅在浏览器中加载