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: Diese Funktion ist in Web Workers verfügbar, mit Ausnahme von Service Workers.
Die XMLHttpRequest-Methode setRequestHeader() setzt den Wert eines HTTP-Anforderungsheaders.
Wenn setRequestHeader() verwendet wird, muss es nach dem Aufruf von open(), aber vor dem Aufruf von send() aufgerufen werden.
Wenn diese Methode mehrmals mit dem gleichen Header aufgerufen wird, werden die Werte zu einem einzigen Anforderungsheader zusammengeführt.
Bei jedem Aufruf von setRequestHeader() nach dem ersten Aufruf wird der angegebene Text an das Ende des bestehenden Headerinhalts angehängt.
Wenn kein Accept-Header mit dieser Methode gesetzt wurde, wird beim Aufruf von send() ein Accept-Header mit dem Typ "*/*" mit der Anfrage gesendet.
Aus Sicherheitsgründen gibt es mehrere verbotene Anforderungsheader, deren Werte vom Benutzeragenten kontrolliert werden. Jeder Versuch, einen Wert für einen dieser Header aus Frontend-JavaScript-Code festzulegen, wird ohne Warnung oder Fehler ignoriert.
Zusätzlich kann der Authorization-HTTP-Header zu einer Anfrage hinzugefügt werden, wird jedoch entfernt, wenn die Anfrage serverübergreifend umgeleitet wird.
Hinweis:
Bei Ihren benutzerdefinierten Feldern kann es zu einer Ausnahme kommen: "not allowed by Access-Control-Allow-Headers in preflight response", wenn Sie domainübergreifende Anfragen senden.
In diesem Fall müssen Sie den Access-Control-Allow-Headers in Ihrem Antwortheader auf Serverseite einrichten.
Syntax
setRequestHeader(header, value)
Parameter
Rückgabewert
Keiner (undefined).
Spezifikationen
| Specification |
|---|
| XMLHttpRequest # the-setrequestheader()-method |
Browser-Kompatibilität
BCD tables only load in the browser