Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten.Erfahre mehr über dieses Experiment.
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 inWeb Workers verfügbar, mit Ausnahme vonService Workers.
DieXMLHttpRequest-EigenschaftresponseType 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 vonresponseType gesetzt wird, wird der Standardwerttext 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 einHTML-DocumentoderXML-XMLDocument, je nach MIME-Typ der empfangenen Daten. SieheHTML 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 alsJSON erstellt wurde."text"Die
responseist ein Text in einem String.
Hinweis:Beim Setzen vonresponseType auf einen bestimmten Wert sollte der Autor sicherstellen, dass der Server tatsächlich eine Antwort liefert, die mit diesem Format kompatibel ist. Wennder Server Daten zurückgibt, die nicht mit dem eingestelltenresponseType kompatibel sind, ist der Wert vonresponsenull.
Ausnahmen
InvalidAccessErrorDOMExceptionEs wurde versucht, den Wert von
responseTypebei einemXMLHttpRequestzu ändern, der im synchronen Modus ist, aber nicht in einemWorker. Für zusätzliche Details sieheEinschränkungen bei synchronem XHR unten.
Verwendungshinweise
Einschränkungen bei synchronem XHR
Sie können den Wert vonresponseType in einem synchronenXMLHttpRequest nicht ändern, es sei denn, die Anfrage gehört zu einemWorker.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, indemfalse als Wert des optionalenasync-Parameters beim Aufruf vonopen() übergeben wird.
Einschränkungen in Workern
Versuche, den Wert vonresponseType aufdocument zu setzen, werden in einemWorker ignoriert.
Spezifikationen
| Specification |
|---|
| XMLHttpRequest # the-responsetype-attribute |
Browser-Kompatibilität
Siehe auch
- Verwendung von XMLHttpRequest
- HTML in XMLHttpRequest
- Die Antwortdaten:
response,responseTextundresponseXML