Response: formData() 方法

Baseline 已广泛支持

此特性已得到良好支持,可在多种设备和浏览器版本上使用。自 2021 年 4 月起,所有浏览器均已支持此特性。

注意:此功能在 Web Workers 中可用。

Response 接口的 formData() 方法会读取一个 Response 流并将其读取完毕。它返回一个解析为 FormData 对象的 Promise。

注意:这主要与 Service Worker 相关。如果用户提交了表单,并且 Service Worker 拦截了该请求,您可以调用 formData() 方法获取一个键值对映射,修改某些字段,然后将表单转发给服务器(或在本地使用)。

语法

js
formData()

参数

无。

返回值

一个解析为 FormData 对象的 Promise

异常

AbortError DOMException

请求已被 中止

TypeError

因以下原因之一而抛出:

  • 响应体已被 干扰或锁定
  • 解码正文内容时出错(例如,因为 Content-Encoding 标头不正确)。
  • 无法从响应中包含的 Content-Type 标头确定主体的 MIME 类型。
  • 无法将主体解析为 FormData 对象。

示例

待定。

规范

规范
Fetch
# ref-for-dom-body-formdata①

浏览器兼容性

另见