XMLHttpRequest: setRequestHeader() Methode

Baseline Weitgehend verfgbar

Diese Funktion ist gut etabliert und funktioniert auf vielen Gerten und in vielen Browserversionen. Sie ist seit Juli 2015 browserbergreifend verfgbar.

Mehr erfahren
Vollstndige Kompatibilitt anzeigen

Hinweis: Diese Funktion ist in Web Workers verfgbar, 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 zusammengefhrt.

Bei jedem Aufruf von setRequestHeader() nach dem ersten Aufruf wird der angegebene Text an das Ende des bestehenden Headerinhalts angehngt.

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 Sicherheitsgrnden gibt es mehrere verbotene Anforderungsheader, deren Werte vom Benutzeragenten kontrolliert werden. Jeder Versuch, einen Wert fr einen dieser Header aus Frontend-JavaScript-Code festzulegen, wird ohne Warnung oder Fehler ignoriert.

Zustzlich kann der Authorization-HTTP-Header zu einer Anfrage hinzugefgt werden, wird jedoch entfernt, wenn die Anfrage serverbergreifend 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 domainbergreifende Anfragen senden. In diesem Fall mssen Sie den Access-Control-Allow-Headers in Ihrem Antwortheader auf Serverseite einrichten.