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
setRequestHeader(header, value)
Parameter
Rückgabewert
Keiner (undefined).
Spezifikationen
| Specification |
|---|
| XMLHttpRequest Standard # the-setrequestheader()-method |
Browser-Kompatibilität
BCD tables only load in the browser