Response:formData() 方法

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since April 2021.

备注: 此特性在 Web Worker 中可用。

Response 接口的 formData() 方法接受一个 Response 流,并完整读取它。它将返回一个会兑现为 FormData 对象的 promise。

备注: 该方法主要与 service worker 有关。如果用户提交了的表单请求被 service worker 所拦截,你可以像下述的示例一样,调用 formData() 方法来获取一个键值映射,修改某些字段,然后将表单发送到服务器(或在本地使用)。

语法

js
formData()

参数

无。

返回值

兑现为 FormData 对象的 Promise

异常

DOMException AbortError

请求被中止

TypeError

因以下原因抛出此异常:

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

示例

待定。

规范

Specification
Fetch
# ref-for-dom-body-formdata①

浏览器兼容性

参见