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 JavaScriptArrayBuffer
, das Binärdaten enthält. "blob"
-
Die
response
ist einBlob
-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 einemXMLHttpRequest
zu ä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 Standard # the-responsetype-attribute |
Browser-Kompatibilität
BCD tables only load in the browser
Siehe auch
- Verwendung von XMLHttpRequest
- HTML in XMLHttpRequest
-
Die Antwortdaten:
response
,responseText
undresponseXML