webRequest.BlockingResponse

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

authCredentials Optional

object. Wenn festgelegt, wird die Anfrage mit den angegebenen Anmeldeinformationen gesendet. Sie können diese Eigenschaft nur in onAuthRequired festlegen. Die authCredentials Eigenschaft ist ein Objekt mit den folgenden Eigenschaften:

username

string. Benutzername, der angegeben werden soll.

password

string. Passwort, das angegeben werden soll.

cancel Optional

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

redirectUrl Optional

string. Dies ist eine URL, und wenn festgelegt, wird die ursprüngliche Anfrage an diese URL umgeleitet. Sie können diese Eigenschaft nur in onBeforeRequest oder onHeadersReceived festlegen.

Umleitungen zu nicht-HTTP-Schemata wie data: sind erlaubt. Umleitungen verwenden dieselbe Anfragemethode wie die ursprüngliche Anfrage, es sei denn, sie werden vom onHeadersReceived-Stadium initiiert. In diesem Fall wird die GET-Methode verwendet.

Wenn eine Erweiterung eine öffentliche (z.B. HTTPS) URL zu einer Erweiterungsseite umleiten möchte, muss die manifest.json-Datei der Erweiterung ein web_accessible_resources Schlüssel enthalten, der die URL der 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 Headers statt der ursprünglichen Headers gesendet. Sie können diese Eigenschaft nur in onBeforeSendHeaders festlegen.

responseHeaders Optional

webRequest.HttpHeaders. Dies ist ein HttpHeaders Objekt, ein Array, in dem jedes Objekt einen Header darstellt. Wenn gesetzt, wird davon ausgegangen, dass der Server mit diesen Antwort-Headers anstelle der ursprünglichen geantwortet hat. Sie können diese Eigenschaft nur in onHeadersReceived festlegen. Wenn mehrere Erweiterungen versuchen, denselben Header festzulegen (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 verhindert, und stattdessen wird eine sichere (HTTPS) Anfrage gemacht. Wenn eine Erweiterung redirectUrl in onBeforeRequest zurückgibt, wird upgradeToSecure für diese Anfrage ignoriert. Sie können diese Eigenschaft nur in onBeforeRequest festlegen.