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。请求的新方案(scheme)。允许的值有 "http""https",以及扩展的方案,例如 Firefox 中的“moz-extension”或 Chrome 中的“chrome-extension”。当使用扩展的方案时,必须指定 host 以生成有意义的重定向目标。

username 可选

string。请求的新用户名。

浏览器兼容性

BCD tables only load in the browser