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 表仅在浏览器中加载