Details describing a URL transformation to perform for a redirect rule. This object can be specified at rule.action.redirect.transform.
On this page
declarativeNetRequest.URLTransform
Type
Values of this type are objects. They contain these properties:
fragmentOptional-
A
string. The new fragment for the request. Should be either empty, in which case the existing fragment is cleared; or should begin with '#'. hostOptional-
A
string. The new host name for the request. passwordOptional-
A
string. The new password for the request. pathOptional-
A
string. The new path for the request. If empty, the existing path is cleared. portOptional-
A
string. The new port for the request. If empty, the existing port is cleared. queryOptional-
A
string. The new query for the request. Should be either empty, in which case the existing query is cleared; or should begin with '?'. queryTransformOptional-
An object describing how to add, remove, or replace query key-value pairs. Cannot be specified if 'query' is specified.
addOrReplaceParamsOptional-
An object describing the list of query key-value pairs to be added or replaced.
-
key -
A
string. The key value. replaceOnlyOptional-
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. -
value -
A
string. The value value.
-
removeParamsOptional-
A
string. The list of query keys to be removed.
schemeOptional-
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, thehostmust be specified to generate a meaningful redirection target. usernameOptional-
A
string. The new username for the request.
Browser compatibility
| 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