declarativeNetRequest.URLTransform
Details zur Beschreibung einer URL-Transformation, die für eine Umleitungsregel durchgeführt werden soll. Dieses Objekt kann bei rule.action
.redirect.transform angegeben werden.
Typ
Werte dieses Typs sind Objekte. Sie enthalten folgende Eigenschaften:
fragment
Optional-
Ein
string
. Das neue Fragment für die Anfrage. Sollte entweder leer sein, in diesem Fall wird das vorhandene Fragment gelöscht; oder es sollte mit '#' beginnen. host
Optional-
Ein
string
. Der neue Hostname für die Anfrage. password
Optional-
Ein
string
. Das neue Passwort für die Anfrage. path
Optional-
Ein
string
. Der neue Pfad für die Anfrage. Wenn leer, wird der vorhandene Pfad gelöscht. port
Optional-
Ein
string
. Der neue Port für die Anfrage. Wenn leer, wird der vorhandene Port gelöscht. query
Optional-
Ein
string
. Die neue Abfrage für die Anfrage. Sollte entweder leer sein, in diesem Fall wird die vorhandene Abfrage gelöscht; oder es sollte mit '?' beginnen. queryTransform
Optional-
Ein Objekt, das beschreibt, wie Abfrage-Schlüssel-Wert-Paare hinzugefügt, entfernt oder ersetzt werden. Kann nicht angegeben werden, wenn 'query' angegeben ist.
addOrReplaceParams
Optional-
Ein Array von Objekten, die die Liste der hinzuzufügenden oder zu ersetzenden Abfrage-Schlüssel-Wert-Paare beschreiben.
key
-
Ein
string
. Der Schlüsselwert. replaceOnly
Optional-
Ein
boolean
. Wenn wahr, wird der Abfrageschlüssel nur ersetzt, wenn er bereits vorhanden ist. Andernfalls wird der Schlüssel auch hinzugefügt, wenn er fehlt. Standardwert ist false. value
-
Ein
string
. Der Wert.
removeParams
Optional-
Ein Array von
string
. Die Liste der zu entfernenden Abfrageschlüssel.
scheme
Optional-
Ein
string
. Das neue Schema für die Anfrage. Zulässige Werte sind"http"
,"https"
und das Schema der Erweiterung, zum Beispiel "moz-extension" in Firefox oder "chrome-extension" in Chrome. Wenn das Erweiterungsschema verwendet wird, muss derhost
angegeben werden, um ein sinnvolles Umleitungsziel zu generieren. username
Optional-
Ein
string
. Der neue Benutzername für die Anfrage.