XMLHttpRequest: responseType 属性
注意:此功能在 Web Workers 中可用,除了 Service Workers。
该 XMLHttpRequest
属性 responseType
是一个枚举字符串值,指定响应中包含的数据类型。
它还允许作者更改响应类型。如果将空字符串设置为 responseType
的值,则使用 text
的默认值。
值
指定响应包含的数据类型的字符串。它可以取以下值
""
-
空
responseType
字符串与"text"
(默认类型)相同。 "arraybuffer"
-
该
response
是一个 JavaScriptArrayBuffer
,包含二进制数据。 "blob"
-
该
response
是一个包含二进制数据的Blob
对象。 "document"
-
该
response
是一个 HTMLDocument
或 XMLXMLDocument
,根据接收到的数据的 MIME 类型确定。请参阅 XMLHttpRequest 中的 HTML,以了解有关使用 XHR 获取 HTML 内容的更多信息。 "json"
-
该
response
是一个 JavaScript 对象,通过将接收到的数据内容解析为 JSON 创建。 "text"
-
该
response
是字符串中的文本。
注意:在将 responseType
设置为特定值时,作者应确保服务器实际上正在发送与该格式兼容的响应。如果服务器返回的数据与设置的 responseType
不兼容,则 response
的值将为 null
。
异常
InvalidAccessError
DOMException
-
尝试在同步模式下但不在
Worker
中更改XMLHttpRequest
的responseType
值。有关更多详细信息,请参阅下面的 同步 XHR 限制。
使用说明
同步 XHR 限制
Workers 中的限制
在 Worker
中,尝试将 responseType
的值设置为 document
将被忽略。
规范
规范 |
---|
XMLHttpRequest 标准 # the-responsetype-attribute |
浏览器兼容性
BCD 表格仅在启用 JavaScript 的浏览器中加载。