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: Diese Funktion ist in Web Workers verfügbar, mit Ausnahme von 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
# the-responsetype-attribute

Browser-Kompatibilität

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
responseType
arraybuffer_value
blob_value
document_value
json_value

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
Has more compatibility info.

Siehe auch