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 November 2016.
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
responseist ein JavaScriptArrayBuffer, das Binärdaten enthält. "blob"-
Die
responseist einBlob-Objekt, das die Binärdaten enthält. "document"-
Die
responseist ein HTML-Documentoder 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
responseist ein JavaScript-Objekt, das durch das Parsen der Inhalte der empfangenen Daten als JSON erstellt wurde. "text"-
Die
responseist 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
InvalidAccessErrorDOMException-
Es wurde versucht, den Wert von
responseTypebei einemXMLHttpRequestzu ändern, der im synchronen Modus ist, aber nicht in einemWorker. 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
Loading…
Siehe auch
- Verwendung von XMLHttpRequest
- HTML in XMLHttpRequest
- Die Antwortdaten:
response,responseTextundresponseXML