XMLHttpRequest API
FormData 接口提供了一种表示表单数据的键值对 key/value 的构造方式,并且可以轻松的将数据通过XMLHttpRequest.send() 方法发送出去,本接口和此方法都相当简单直接。如果送出时的编码类型被设为 "multipart/form-data",它会使用和表单一样的格式。
如果你想构建一个简单的GET请求,并且通过form的形式带有查询参数,可以将它直接传递给URLSearchParams。
实现了 FormData 接口的对象可以直接在Statements/for...of结构中使用,而不需要调用FormData.entries() : for (var p of myFormData) 的作用和 for (var p of myFormData.entries()) 是相同的。
构造函数
- FormData.FormData
- : 创建一个新的
FormData对象。
- : 创建一个新的
方法
- FormData.append()
- : 向
FormData中添加新的属性值,FormData对应的属性值存在也不会覆盖原值,而是新增一个值,如果属性不存在则新增一项属性值。
- : 向
- FormData.delete()
- : 从 FormData 对象里面删除一个键值对。
- FormData.entries()
- : 返回一个包含所有键值对的Iteration_protocols对象。
- FormData.get()
- :
返回在 FormData对象中与给定键关联的第一个值。
- :
- FormData.getAll()
- : 返回一个包含
FormData对象中与给定键关联的所有值的数组。
- : 返回一个包含
- FormData.has()
- :
返回一个布尔值表明 FormData对象是否包含某些键。
- :
- FormData.keys()
- : 返回一个包含所有键的Iteration_protocols对象。
- FormData.set()
- : 给
FormData设置属性值,如果FormData对应的属性值存在则覆盖原值,否则新增一项属性值。
- : 给
- FormData.values()
- : 返回一个包含所有值的Iteration_protocols对象。
规范
浏览器兼容性
参见
- XMLHTTPRequest
- 使用 XMLHttpRequest
- 使用 FormData 对象
- Form
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
