XMLHttpRequest: getResponseHeader() Methode
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 den String zurück, der den Text des Werts eines bestimmten Headers enthält.
Wenn es mehrere Antwort-Header mit demselben Namen gibt, werden ihre Werte als einzelner, zusammengefügter String zurückgegeben, wobei jeder Wert durch ein Komma und ein Leerzeichen vom vorherigen getrennt ist. Die Methode getResponseHeader() gibt den Wert als UTF-Byte-Sequenz zurück.
Hinweis: Die Suche nach dem Header-Namen unterscheidet nicht zwischen Groß- und Kleinschreibung.
Wenn Sie den Roh-String aller Header benötigen, verwenden Sie die Methode getAllResponseHeaders(), die den gesamten Roh-Header-String zurückgibt.
Syntax
getResponseHeader(headerName)
Parameter
headerName-
Ein String, der den Namen des Headers angibt, dessen Textwert Sie zurückgeben möchten.
Rückgabewert
Ein String, der den Textwert des Headers darstellt, 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 wird eingerichtet, um auf den readyState zu prüfen, der darauf hinweist, dass die Header empfangen wurden; wenn dies der Fall ist, wird der Wert des Content-Type Headers abgerufen. Wenn der Content-Type nicht der gewünschte Wert ist, wird der XMLHttpRequest durch Aufrufen 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 !== myExpectedType) {
client.abort();
}
}
};
Spezifikationen
| Specification |
|---|
| XMLHttpRequest # dom-xmlhttprequest-getresponseheader |
Browser-Kompatibilität
Siehe auch
- Verwendung von XMLHttpRequest
- HTTP-Header
getAllResponseHeaders()response- Setzen von Anforderungs-Headern:
setRequestHeader()