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