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 gemacht. Diese Eigenschaft kann nur in onAuthRequired gesetzt werden. Die Eigenschaft authCredentials ist ein Objekt mit den folgenden Eigenschaften:

username

string. Bereitzustellender Benutzername.

password

string. Bereitzustellendes 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 sie gesetzt ist, 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. Weiterleitungen verwenden dieselbe Anfragemethode wie die ursprüngliche Anfrage, es sei denn, sie werden in der onHeadersReceived-Phase initiiert. In diesem Fall verwendet die Weiterleitung die GET-Methode.

Wenn eine Erweiterung eine öffentliche (z.B. HTTPS) URL zu einer Erweiterungsseite umleiten möchte, muss die Manifestdatei der Erweiterung manifest.json 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 gemacht. 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 ursprünglichen geantwortet hat. Diese Eigenschaft kann nur in onHeadersReceived gesetzt werden. Wenn mehrere Erweiterungen versuchen, denselben 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, sondern eine sichere (HTTPS)-Anfrage gemacht. 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