一 、概况
FormData接口提供了一种表示表单数据的键值对 name/value 的构造方式,能够将数据通过前端 Ajax 请求发送给后端。
FormData的主要用途有两个:
-
异步上传文件。
-
实现form表单数据的序列化,将数据以键值对 name/value 的形式传到后台,从而减少表单元素的拼接,提高工作效率。
-
二、如何使用
(1)创建一个FormData对象
1 // 通过new FormData() 来创建一个对象 2 let formData = new FormData();
(2)对象名.append(name,value)
append(name: string, value: string | Blob, fileName?: string): void;
向FormData中添加新的属性值,就算FormData里面已经存在了对应的name值,也不会被覆盖掉,而是新增一个属性值;如果存在一个name对应多个value,可通过getAll()方法获取。
1 formData.append('status', this.addForm.status);
(3)对象名.delete(name)
delete(name: string): void;
通过name删除FormData中对应的value。
1 formData.delete('status');
(4)对象名.get(name)
get(name: string): FormDataEntryValue | null;
从FormData中获取name对应的value。如果name对应多个value,此方法返回第一个value值。
1 const status= formData.get('status');
(5)对象名.getAll(name)
getAll(name: string): FormDataEntryValue[];
从FormData中获取key对应的value。如果name对应多个value,此方法返回value数组。
1 const status= formData.getAll('status');
(6)对象名.has(name)
has(name: string): boolean;
判断FormData中是否存在对应的name。存在,返回true;不存在,返回false。
1 formData.has('status')
(7)对象名.set(name,value)
set(name: string, value: string | Blob, fileName?: string): void;
给FormData设置一个属性值,如果FormData对应的属性值存在 则覆盖之前的属性值,否则新增一个属性值;
如果第二个参数传递的是一个Blob对象或者File对象,那么第三个参数fileName就需要传入文件名(传给服务端)。
1 formData.set('status','2') 2 formData.set('files', myFile.file(0),'myFileName.png')
(8)对象名.entries()
方法返回一个迭代器(iterator),可以遍历访问FormData中的所有键值对。
1 for(var pair of formData.entries()) { 2 console.log(pair[0]+ ', '+ pair[1]); // pair[0]为name ,pair[1]为value 3 }
(9)对象名.keys()
该方法返回一个迭代器(iterator),可以遍历访问FormData中的所有name。1 for (var name of formData.keys()) { 2 console.log(name); 3 }
(10)对象名.values()
方法返回一个迭代器(iterator),可以遍历访问FormData中的所有value。
1 for (var value of formData.values()) { 2 console.log(value); 3 }