webRequest.BlockingResponse

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. Bereitzustellender Benutzername.

password

string. Bereitzustellendes Passwort.

cancel Optional

boolean. Wenn true, wird die Anfrage abgebrochen. Sie können diese Eigenschaft nur in onBeforeRequest, onBeforeSendHeaders, onHeadersReceived, und onAuthRequired setzen.

redirectUrl Optional

string. Dies ist eine URL, und wenn gesetzt, wird die ursprüngliche Anfrage zu dieser URL umgeleitet. Sie können diese Eigenschaft nur in onBeforeRequest oder onHeadersReceived setzen.

Umleitungen zu Nicht-HTTP-Schemata wie data: sind erlaubt. Umleitungen verwenden die gleiche Anfragemethode wie die ursprüngliche Anfrage, es sei denn, sie werden von der onHeadersReceived-Phase initiiert, in diesem Fall wird die Umleitung mit der GET-Methode durchgeführt.

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 statt mit den ursprünglichen durchgeführt. Sie können diese Eigenschaft nur in onBeforeSendHeaders setzen.

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 statt mit den ursprünglichen geantwortet hat. Sie können diese Eigenschaft nur in onHeadersReceived setzen. Wenn mehrere Erweiterungen versuchen, den gleichen Header zu setzen (zum Beispiel Content-Security-Policy), 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 und stattdessen eine sichere (HTTPS) Anfrage ausgeführt. Wenn eine Erweiterung redirectUrl in onBeforeRequest zurückgibt, wird upgradeToSecure für diese Anfrage ignoriert. Sie können diese Eigenschaft nur in onBeforeRequest setzen.