FormData
基线 广泛可用
此功能已十分成熟,可以在许多设备和浏览器版本上运行。它从 2015 年 7 月.
报告反馈
注意: 此功能在 Web Workers 中可用。
FormData
接口提供了一种方式来构建一组表示表单字段及其值的键值对,可以使用 fetch()
、XMLHttpRequest.send()
或 navigator.sendBeacon()
方法发送这些键值对。它使用与表单使用相同的格式,前提是编码类型设置为 "multipart/form-data"
。
如果您想以与 <form>
在使用简单的 GET
提交时相同的方式生成查询参数,则可以直接将其传递给 URLSearchParams
构造函数。
构造函数
FormData()
-
实现
FormData
的对象可以直接在for...of
结构中使用,而不是entries()
:for (const p of myFormData)
等效于for (const p of myFormData.entries())
。
实例方法
创建一个新的
FormData
对象。-
FormData.append()
将一个新值附加到
FormData
对象中现有键上,或者如果键不存在,则添加该键。-
FormData.delete()
从
FormData
对象中删除一个键值对。-
FormData.entries()
返回一个 迭代器,该迭代器遍历
FormData
中包含的所有键值对。-
FormData.get()
返回
FormData
对象中与给定键关联的第一个值。-
FormData.getAll()
返回
FormData
对象中与给定键关联的所有值的数组。-
FormData.has()
返回
FormData
对象是否包含某个键。-
FormData.keys()
返回一个 迭代器,该迭代器遍历
FormData
中包含的所有键值对的键。-
FormData.set()
为
FormData
对象中现有键设置一个新值,或者如果键不存在,则添加键值对。-
FormData.values()
规范
返回一个 迭代器,该迭代器遍历 FormData 中包含的所有值。 |
---|
规范 # XMLHttpRequest 标准 |
浏览器兼容性
interface-formdata