Details describing a URL transformation to perform for a redirect rule. This object can be specified at rule.action.redirect.transform.
Details describing a URL transformation to perform for a redirect rule. This object can be specified at rule.action.redirect.transform.
Values of this type are objects. They contain these properties:
fragment Optional
A string. The new fragment for the request. Should be either empty, in which case the existing fragment is cleared; or should begin with '#'.
host Optional
A string. The new host name for the request.
password Optional
A string. The new password for the request.
path Optional
A string. The new path for the request. If empty, the existing path is cleared.
port Optional
A string. The new port for the request. If empty, the existing port is cleared.
query Optional
A string. The new query for the request. Should be either empty, in which case the existing query is cleared; or should begin with '?'.
queryTransform Optional
An object describing how to add, remove, or replace query key-value pairs. Cannot be specified if 'query' is specified.
addOrReplaceParams Optional
An object describing the list of query key-value pairs to be added or replaced.
keyA string. The key value.
replaceOnly Optional
A boolean. If true, the query key is replaced only if it's already present. Otherwise, the key is also added if it's missing. Defaults to false.
valueA string. The value value.
removeParams Optional
A string. The list of query keys to be removed.
scheme Optional
A string. The new scheme for the request. Allowed values are "http", "https", and the scheme of the extension, for example, "moz-extension" in Firefox or "chrome-extension" in Chrome. When the extension scheme is used, the host must be specified to generate a meaningful redirection target.
username Optional
A string. The new username for the request.
| Desktop | Mobile | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | WebView Android | Chrome Android | Firefox for Android | Opera Android | Safari on IOS | Samsung Internet | |
URLTransform |
84 | 84 | No | ? | 70 | 15.4 | ? | ? | No | ? | 15.4 | ? |
queryTransform |
84 | 84 | No | ? | 70 | 15.4 | ? | ? | No | ? | 15.4 | ? |
© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/API/declarativeNetRequest/URLTransform