XMLHttpRequest: Methode getResponseHeader()
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since Juli 2015.
Hinweis: Diese Funktion ist in Web Workers verfügbar, mit Ausnahme von Service Workers.
Die Methode getResponseHeader() des XMLHttpRequest gibt die Zeichenkette zurück, die den Textwert eines bestimmten Headers enthält.
Wenn es mehrere Antwort-Header mit demselben Namen gibt, werden deren Werte als eine einzige verkettete Zeichenkette zurückgegeben, wobei jeder Wert von dem vorhergehenden durch ein Komma und ein Leerzeichen getrennt ist. Die Methode getResponseHeader() gibt den Wert als UTF-Byte-Sequenz zurück.
Hinweis: Die Suche nach dem Headernamen erfolgt ohne Berücksichtigung der Groß-/Kleinschreibung.
Wenn Sie den Rohstring aller Header benötigen, verwenden Sie die Methode getAllResponseHeaders(), die den gesamten Roh-Header-String zurückgibt.
Syntax
getResponseHeader(headerName)
Parameter
headerName-
Eine Zeichenkette, die den Namen des Headers angibt, dessen Textwert Sie zurückgeben möchten.
Rückgabewert
Eine Zeichenkette, die den Textwert des Headers repräsentiert, oder null, wenn entweder die Antwort noch nicht eingegangen ist oder der Header in der Antwort nicht existiert.
Beispiele
In diesem Beispiel wird eine Anfrage erstellt und gesendet und ein readystatechange
Handler eingerichtet, um nach dem readyState zu suchen, der anzeigt, dass die Header empfangen wurden; in diesem Fall wird der Wert des Content-Type Headers abgerufen. Wenn der Content-Type nicht den gewünschten Wert hat, wird der XMLHttpRequest durch Aufruf von abort() abgebrochen.
const client = new XMLHttpRequest();
client.open("GET", "unicorns-are-awesome.txt", true);
client.send();
client.onreadystatechange = () => {
if (client.readyState === client.HEADERS_RECEIVED) {
const contentType = client.getResponseHeader("Content-Type");
if (contentType !== my_expected_type) {
client.abort();
}
}
};
Spezifikationen
| Specification |
|---|
| XMLHttpRequest # dom-xmlhttprequest-getresponseheader |
Browser-Kompatibilität
Loading…
Siehe auch
- Verwendung von XMLHttpRequest
- HTTP-Header
getAllResponseHeaders()response- Festlegen von Anfrage-Headern:
setRequestHeader()