大网数据广告活动
Web 标准与前端开发

XMLHttpRequest.responseType

· 52CE 我爱测

XMLHttpRequest 属性 **`responseType`** 是一个枚举字符串值,用于指定响应中包含的数据类型。

XMLHttpRequest

XMLHttpRequest 属性 responseType 是一个枚举字符串值,用于指定响应中包含的数据类型。

它还允许作者更改响应类型。如果将 responseType 的值设置为空字符串,则会使用 text 作为默认值。

语法

var type = XMLHttpRequest.responseType;

XMLHttpRequest.responseType = type;

值

Global_Objects/String 类型的值,指定响应包含的数据类型。它可以采用以下值:

  • ""
    • : 空的 responseType 字符串与默认类型 "text" 相同。
  • "arraybuffer"
    • : XMLHttpRequest.response 是一个包含二进制数据的 JavaScript ArrayBuffer。
  • "blob"
    • : XMLHttpRequest.response 是一个包含二进制数据的 Blob 对象。
  • "document"
    • : XMLHttpRequest.response 是一个 HTML Document 或 XML XMLDocument,根据接收到的数据的 MIME 类型而定。请参阅 XMLHttpRequest 中的 HTML,了解有关使用 XHR 获取 HTML 内容的更多信息。
  • "json"
    • : XMLHttpRequest.response 是通过将接收到的数据内容解析为 JSON 而创建的 JavaScript 对象。
  • "text"
    • : XMLHttpRequest.response 是 String 对象中的文本。
  • "ms-stream"
    • : XMLHttpRequest.response 是流式下载的一部分;此响应类型仅允许用于下载请求,并且仅受 Internet Explorer 支持。

[!NOTE] 将 responseType 设置为特定值时,作者应确保服务器实际发送的响应与该格式兼容。如果服务器返回的数据与设置的 responseType 不兼容,则 XMLHttpRequest.response 的值将为null .

异常

  • InvalidAccessError
    • : 试图更改 XMLHttpRequest 的 responseType,该值处于同步模式但不在 Worker 中。有关其他详细信息,请参阅下面的 同步 XHR 限制。

使用说明

同步 XHR 限制

你不能在同步XMLHttpRequest 中更改 responseType 的值,除非请求属于 Worker。此限制部分旨在帮助确保同步操作不会用于阻塞浏览器主线程的大型事务,从而阻碍用户体验。

XHR 请求默认是异步的;它们仅通过在调用 XMLHttpRequest.open 时将 false 作为可选async 参数的值传递来置于同步模式。

Worker 中的限制

在 Worker 中尝试将 responseType 的值设置为 document 时会被忽略。

规范

浏览器兼容性

参见

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。