webRequest.BlockingResponse

Typ

Werte dieses Typs sind Objekte. Sie enthalten die folgenden Eigenschaften:

authCredentials Optional

object. Wenn gesetzt, wird die Anfrage mit den angegebenen Anmeldedaten durchgeführt. Sie können diese Eigenschaft nur in onAuthRequired setzen. Die authCredentials Eigenschaft ist ein Objekt mit den folgenden Eigenschaften:

username

string. Bereitgestellter Benutzername.

password

string. Bereitgestelltes Passwort.

cancel Optional

boolean. Wenn true, wird die Anfrage abgebrochen. Diese Eigenschaft kann nur in onBeforeRequest, onBeforeSendHeaders, onHeadersReceived, und onAuthRequired gesetzt werden.

redirectUrl Optional

string. Dies ist eine URL, und wenn gesetzt, wird die ursprüngliche Anfrage zu dieser URL umgeleitet. Diese Eigenschaft kann nur in onBeforeRequest oder onHeadersReceived gesetzt werden.

Umleitungen zu nicht-HTTP-Schemata wie data: sind erlaubt. Umleitungen verwenden dieselbe Anfragemethode wie die ursprüngliche Anfrage, es sei denn, die Umleitung wird aus der onHeadersReceived-Phase initiiert, in diesem Fall verwendet die Umleitung die GET-Methode.

Wenn eine Erweiterung eine öffentliche (z.B. HTTPS) URL auf eine Erweiterungsseite umleiten möchte, muss die manifest.json-Datei der Erweiterung einen web_accessible_resources Schlüssel enthalten, der die URL für die Erweiterungsseite auflistet.

requestHeaders Optional

webRequest.HttpHeaders. Dies ist ein HttpHeaders Objekt, ein Array, in dem jedes Objekt einen Header darstellt. Wenn gesetzt, wird die Anfrage mit diesen Headern anstelle der ursprünglichen Header durchgeführt. Diese Eigenschaft kann nur in onBeforeSendHeaders gesetzt werden.

responseHeaders Optional

webRequest.HttpHeaders. Dies ist ein HttpHeaders Objekt, ein Array, in dem jedes Objekt einen Header darstellt. Wenn gesetzt, wird angenommen, dass der Server mit diesen Antwort-Headern anstelle der Originale geantwortet hat. Diese Eigenschaft kann nur in onHeadersReceived gesetzt werden. Wenn mehrere Erweiterungen versuchen, denselben Header (zum Beispiel Content-Security-Policy) zu setzen, wird nur eine der Änderungen erfolgreich sein.

upgradeToSecure Optional

boolean. Wenn auf true gesetzt und die ursprüngliche Anfrage eine HTTP-Anfrage ist, wird die ursprüngliche Anfrage nicht gesendet, sondern stattdessen eine sichere (HTTPS) Anfrage gestellt. Wenn eine Erweiterung redirectUrl in onBeforeRequest zurückgibt, wird upgradeToSecure für diese Anfrage ignoriert. Diese Eigenschaft kann nur in onBeforeRequest gesetzt werden.

Browser-Kompatibilität