FormData类型其实是在XMLHttpRequest 2级定义的,它是为序列化表以及创建与表单格式相同的数据(当然是用于XHR传输)提供便利。
1、构造函数
- 创建一个空对象实例。可以通过调用append()方法进行添加数据。
var formData = new FormData();
- 使用已有的表单来初始化一个对象实例
<form id="myForm" action="" method="post">
<input type="text" name="username"/>
<input type="password" name="password"/>
<button type="submit">提交</button>
</form>
可以使用这个表单元素作为初始化参数,来实例化一个formData对象。
// 获取页面已有的form表单
var myform = document.getElementById('myForm');
// 用表单来初始化
var formData = new FormData(myform);
// 可以根据表单元素的name属性值来访问表单中的字段
var username = formData.get('username'); // 获取用户名字
var paasword = formData.get('password'); // 获取用户密码
// 也可以在此基础上,添加其他数据
formData.append('sex','male');
2、操作方法
首先,要明确formData里面存储的数据形式,一对key/value组成一条数据,key是唯一的,一个key可能对应多个value。如果是是用表单初始化,每一个表单字段对应一条数据,它们的HTML name属性即为key值,它们value属性对应value值。
- 获取值
可以通过get(key)/getAll(key)来获取对应的value。
formData.get('username'); // 获取key为username的第一个值
formData.getAll('username'); // 返回一个数组,获取Key为name的所有值
- 添加数据
通过append(key,value)来添加数据,如果指定的key不存在则会新增一条数据,如果key存在,则添加到数据的末尾。
formData.append('key1','val-1');
formData.append('key1','val-2');
formData.append('key1','val-1');
formData.get('key1'); // "val-1"
formData.getAll('key1'); // ["val-1","val-2","val-1"]
- 设置修改数据
通过set(key,value)来设置修改数据,如果指定的key不存在则会新增一条,如果存在,则会修改对应的value值。
formData.append('key1','val-1');
formData.set('key1','val-2');
formData.getAll('key1'); // ["val-1"]
- 判断是否存在该数据
通过has(key)来判断是否对应的key值。
formData.append('key1',null);
formData.has('key1'); // true
formData.has('key2'); // false
- 删除数据
通过delete(key)来删除数据。
formData.append('k1','v1');
formData.append('k1','v2');
formData.delete('k1');
formData.getAll('k1'); // []
- 遍历
通过entries()来获取一个迭代器,然后遍历所有的数据。
formData.append('k1','value-1');
formData.append('k1','value-2');
formData.append('k2','value-3');
var i = formData.entries();
i.next(); // {done:false,value:["k1","value-1"]}
i.next(); // {done:false,value:["k1","value-2"]}
i.next(); // {done:false,value:["k2","value-3"]}
i.next(); // {done:true,value:undefined}
可以看到返回迭代器的规则:
1.每调用一次next()返回一条数据,数据的顺序由添加的顺序决定。
2.返回的是一个对象,当其done属性为true时,说明已经遍历完所有的数据,这个也可以作为判断的依据。
3.返回的对象的value属性以数组形式存储了一对key/value,数组下标0为key,下标1为value,如果一个key值对应多个value,会变成多对key/value返回。
还可以通过values()方法只获取value值。
3、发送数据
可以通过xhr来发送数据,这种方式可以来实现文件的异步上传。
var xhr = new XMLHttpRequest();
xhr.open("post","login");
xhr.setRequestHeader("Content-Type","application/x-www-form-urlencoded");
xhr.send(formData);