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。请求的新用户名。

浏览器兼容性