declarativeNetRequest.URLTransform

Details zur Beschreibung einer URL-Transformation für eine Umleitungsregel. 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, wobei das vorhandene Fragment gelöscht wird, oder 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. Ist dieser leer, wird der vorhandene Pfad gelöscht.

port Optional

Ein string. Der neue Port für die Anfrage. Ist dieser leer, wird der vorhandene Port gelöscht.

query Optional

Ein string. Die neue Abfrage für die Anfrage. Sollte entweder leer sein, wobei die vorhandene Abfrage gelöscht wird, oder mit '?' beginnen.

queryTransform Optional

Ein Objekt, das beschreibt, wie Abfrage-Schlüssel-Wert-Paare hinzugefügt, entfernt oder ersetzt werden sollen. Kann nicht angegeben werden, wenn 'query' spezifiziert ist.

addOrReplaceParams Optional

Ein Array von Objekten, das die Liste der hinzuzufügenden oder zu ersetzenden Abfrage-Schlüssel-Wert-Paare beschreibt.

key: Ein string. Der Schlüsselwert.
replaceOnly Optional: Ein boolean. Wenn true, wird der Abfrageschlüssel nur ersetzt, wenn er bereits vorhanden ist. Andernfalls wird der Schlüssel auch hinzugefügt, wenn er fehlt. Standardmäßig false.
value: Ein string. Der Wertwert.

removeParams Optional

Ein Array von string. Die Liste der zu entfernenden Abfrageschlüssel.

scheme Optional

Ein string. Das neue Schema für die Anfrage. Erlaubte 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 der host angegeben werden, um ein sinnvolles Umleitungsziel zu erzeugen.

username Optional

Ein string. Der neue Benutzername für die Anfrage.