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:
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.
-
key
-
A
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. -
value
-
A
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, thehost
must be specified to generate a meaningful redirection target. username
Optional-
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