XMLHttpRequest: setRequestHeader() Methode

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Hinweis: Dieses Feature ist verfügbar in Web Workers, außer in Service Workers.

Die XMLHttpRequest-Methode setRequestHeader() setzt den Wert eines HTTP-Anforderungs-Headers. Wenn Sie setRequestHeader() verwenden, müssen Sie es nach dem Aufruf von open(), aber vor dem Aufruf von send() aufrufen. Wenn diese Methode mehrmals mit demselben Header aufgerufen wird, werden die Werte zu einem einzigen Anforderungs-Header zusammengeführt.

Jedes Mal, wenn Sie setRequestHeader() nach dem ersten Aufruf verwenden, wird der angegebene Text an das Ende des bestehenden Header-Inhalts angehängt.

Wenn kein Accept-Header mit dieser Methode gesetzt wurde, wird ein Accept-Header mit dem Typ "*/*" mit der Anforderung gesendet, wenn send() aufgerufen wird.

Aus Sicherheitsgründen gibt es mehrere verbotene Header-Namen, deren Werte durch den Benutzeragent gesteuert werden. Jeder Versuch, einen Wert für diese Header aus Frontend-JavaScript-Code zu setzen, wird ohne Warnung oder Fehler ignoriert.

Zusätzlich kann der HTTP-Header Authorization zu einer Anforderung hinzugefügt werden, wird aber entfernt, wenn die Anforderung plattformübergreifend weitergeleitet wird.

Hinweis: Bei Ihren benutzerdefinierten Feldern kann beim Senden von Anfragen über Domänen hinweg eine Ausnahme "nicht erlaubt durch Access-Control-Allow-Headers in der Preflight-Antwort" auftreten. In diesem Fall müssen Sie den Access-Control-Allow-Headers in Ihrem Antwort-Header auf der Serverseite einrichten.

Syntax

js
setRequestHeader(header, value)

Parameter

Der Name des Headers, dessen Wert gesetzt werden soll.

value

Der Wert, der als Inhalt des Headers gesetzt werden soll.

Rückgabewert

Keiner (undefined).

Spezifikationen

Specification
XMLHttpRequest Standard
# the-setrequestheader()-method

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch