webRequest.BlockingResponse

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

authCredentials Optional

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

username

string. Bereitzustellender Benutzername.

password

string. Bereitzustellendes Passwort.

cancel Optional

boolean. Falls 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 auf diese URL umgeleitet. Sie können diese Eigenschaft nur in onBeforeRequest oder onHeadersReceived setzen.

Umleitungen zu Nicht-HTTP-Schemata wie data: sind erlaubt. Weiterleitungen verwenden dieselbe Anfragemethode wie die ursprüngliche Anfrage, es sei denn, sie werden aus der onHeadersReceived-Phase initiiert. In diesem Fall verwendet die Weiterleitung 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. 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 anstelle der Originale geantwortet hat. Sie können diese Eigenschaft nur in onHeadersReceived setzen. Wenn mehrere Erweiterungen versuchen, denselben Header (z. B. 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 und stattdessen eine sichere (HTTPS) Anfrage gestellt. Wenn eine Erweiterung redirectUrl in onBeforeRequest zurückgibt, wird upgradeToSecure für diese Anfrage ignoriert. Sie können diese Eigenschaft nur in onBeforeRequest setzen.