XMLHttpRequest: responseType Eigenschaft

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: Dieses Feature ist verfügbar in Web Workers, außer in Service Workers.

Die XMLHttpRequest-Eigenschaft responseType ist ein enumerierter String-Wert, der den Typ der im Antwort enthaltenen Daten angibt.

Sie ermöglicht es dem Autor auch, den Antworttyp zu ändern. Wenn ein leerer String als Wert von responseType gesetzt wird, wird der Standardwert text verwendet.

Wert

Ein String, der angibt, welcher Typ von Daten die Antwort enthält. Er kann die folgenden Werte annehmen:

""

Ein leerer responseType-String ist dasselbe wie "text", der Standardtyp.

"arraybuffer"

Die response ist ein JavaScript ArrayBuffer, das Binärdaten enthält.

"blob"

Die response ist ein Blob-Objekt, das die Binärdaten enthält.

"document"

Die response ist ein HTML-Document oder XML-XMLDocument, je nach MIME-Typ der empfangenen Daten. Siehe HTML in XMLHttpRequest, um mehr über die Verwendung von XHR zum Abrufen von HTML-Inhalten zu erfahren.

"json"

Die response ist ein JavaScript-Objekt, das durch das Parsen der Inhalte der empfangenen Daten als JSON erstellt wurde.

"text"

Die response ist ein Text in einem String.

Hinweis: Beim Setzen von responseType auf einen bestimmten Wert sollte der Autor sicherstellen, dass der Server tatsächlich eine Antwort liefert, die mit diesem Format kompatibel ist. Wenn der Server Daten zurückgibt, die nicht mit dem eingestellten responseType kompatibel sind, ist der Wert von response null.

Ausnahmen

InvalidAccessError DOMException

Es wurde versucht, den Wert von responseType bei einem XMLHttpRequest zu ändern, der im synchronen Modus ist, aber nicht in einem Worker. Für zusätzliche Details siehe Einschränkungen bei synchronem XHR unten.

Verwendungshinweise

Einschränkungen bei synchronem XHR

Sie können den Wert von responseType in einem synchronen XMLHttpRequest nicht ändern, es sei denn, die Anfrage gehört zu einem Worker. Diese Einschränkung soll teilweise sicherstellen, dass synchrone Operationen nicht für große Transaktionen verwendet werden, die den Hauptthread des Browsers blockieren und somit die Benutzererfahrung beeinträchtigen.

XHR-Anfragen sind standardmäßig asynchron; sie werden nur im synchronen Modus ausgeführt, indem false als Wert des optionalen async-Parameters beim Aufruf von open() übergeben wird.

Einschränkungen in Workern

Versuche, den Wert von responseType auf document zu setzen, werden in einem Worker ignoriert.

Spezifikationen

Specification
XMLHttpRequest Standard
# the-responsetype-attribute

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch