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

js
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.

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

Browser-Kompatibilität

Siehe auch