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 July 2015.

Hinweis: Diese Funktion ist in Web Workers verfügbar, mit Ausnahme von Service Workers.

Die XMLHttpRequest-Methode getResponseHeader() gibt den String zurück, der den Text eines bestimmten Header-Werts enthält.

Wenn es mehrere Antwort-Header mit demselben Namen gibt, werden deren Werte als ein einzelner zusammengefasster 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 erfolgt ohne Berücksichtigung der Groß- und Kleinschreibung.

Wenn Sie den rohen String aller Header benötigen, verwenden Sie die Methode getAllResponseHeaders(), die den gesamten Roh-Header-String zurückgibt.

Syntax

js
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 die Antwort noch nicht empfangen wurde 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 achten, der anzeigt, dass die Header empfangen wurden; in diesem Fall wird der Wert des Content-Type-Headers abgerufen. Wenn der Content-Type nicht der gewünschte Wert ist, wird das XMLHttpRequest durch Aufrufen von abort() abgebrochen.

js
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 Standard
# dom-xmlhttprequest-getresponseheader

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch