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

浏览器兼容性

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Firefox for Android
Safari on iOS
URLTransform
queryTransform
queryTransform.addOrReplaceParams
addOrReplaceParams.replaceOnly

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support