[转] HTML5 FormData 方法介绍以及实现文件上传

XMLHttpRequest 是一个浏览器接口，经过它，咱们可使得 Javascript 进行 HTTP (S) 通讯。XMLHttpRequest 在如今浏览器中是一种经常使用的先后台交互数据的方式。2008年 2 月，XMLHttpRequest Level 2 草案提出来了，相对于上一代，它有一些新的特性，其中 FormData 就是 XMLHttpRequest Level 2 新增的一个对象，利用它来提交表单、模拟表单提交，固然最大的优点就是能够上传二进制文件。下面就具体介绍一下如何利用 FormData 来上传文件。

FormData 上传文件实例

首先看一下formData的基本用法：FormData对象，能够把全部表单元素的name与value组成一个queryString，提交到后台。只须要把 form 表单做为参数传入 FormData 构造函数便可：

var form = document.getElementById("form1"); var fd = new FormData(form);

• 1
• 2

这样就能够直接经过ajax 的 send() 方法将 fd 发送到后台。

如下建立了一个表单 form，表单中除了普通的数据外，还有文件上传，咱们直接将 form对象做为参数传入FormData对象：

<form name="form1" id="form1"> <p>name:<input type="text" name="name" /></p> <p>gender:<input type="radio" name="gender" value="1" />male <input type="radio" name="gender" value="2" />female</p> <p>stu-number：<input type="text" name="number" /></p> <p>photo:<input type="file" name="photo" id="photo"></p> <p><input type="button" name="b1" value="submit" onclick="fsubmit()" /></p> </form> <div id="result"></div>

• 1
• 2
• 3
• 4
• 5
• 6
• 7
• 8

上述代码建立一个form，简单的填写一些信息，以及选择一张图片做为头像，设置一个div来存放返回的结果。

为了简便，咱们仍是采用jquery封装的ajax来向后台传输数据：

function fsubmit() { var form=document.getElementById("form1"); var fd =new FormData(form); $.ajax({ url: "server.php", type: "POST", data: fd, processData: false, // 告诉jQuery不要去处理发送的数据 contentType: false, // 告诉jQuery不要去设置Content-Type请求头 success: function(response,status,xhr){ console.log(xhr); var json=$.parseJSON(response); var result = ''; result +="我的信息：<br/>name:"+json['name']+"<br/>gender:"+json['gender']+"<br/>number:"+json['number']; result += '<br/>头像：<img src="' + json['photo'] + '" height="100" style="border-radius: 50%;" />'; $('#result').html(result); } }); return false; } 

• 1
• 2
• 3
• 4
• 5
• 6
• 7
• 8
• 9
• 10
• 11
• 12
• 13
• 14
• 15
• 16
• 17
• 18
• 19
• 20
• 21

上述代码中的 server.php 是服务器端的文件，接收ajax请求，并将接收结果返回，具体代码以下：

<?php $name = isset($_POST['name'])? $_POST['name'] : ''; $gender = isset($_POST['gender'])? $_POST['gender'] : ''; $number = isset($_POST['number'])? $_POST['number'] : ''; $filename = time().substr($_FILES['photo']['name'], strrpos($_FILES['photo']['name'],'.')); $response = array(); if(move_uploaded_file($_FILES['photo']['tmp_name'], $filename)){ $response['isSuccess'] = true; $response['name'] = $name; $response['gender'] = $gender; $response['number'] = $number; $response['photo'] = $filename; }else{ $response['isSuccess'] = false; } echo json_encode($response); ?> 

• 1
• 2
• 3
• 4
• 5
• 6
• 7
• 8
• 9
• 10
• 11
• 12
• 13
• 14
• 15
• 16
• 17
• 18
• 19
• 20
• 21

填写好信息后，点击 submit，页面中能获得如下效果，去服务器端对应的文件夹下也能发现上传的图片。

若是你是原生 JavaScript 爱好者，固然同样能实现以上功能，下面是简单的JavaScript实现代码：

function fsubmit() { var form=document.getElementById("form1"); var formData=new FormData(form); alert(formData.name); var oReq = new XMLHttpRequest(); oReq.onreadystatechange=function(){ if(oReq.readyState==4){ if(oReq.status==200){ console.log(typeof oReq.responseText); var json=JSON.parse(oReq.responseText); var result = ''; result +="我的信息：<br/>name:"+json['name']+"<br/>gender:"+json['gender']+"<br/>number:"+json['number']; result += '<br/>头像：<img src="' + json['photo'] + '" height="50" style="border-radius: 50%;" />'; $('#result').html(result); } } }; oReq.open("POST", "server.php"); oReq.send(formData); return false; }

• 1
• 2
• 3
• 4
• 5
• 6
• 7
• 8
• 9
• 10
• 11
• 12
• 13
• 14
• 15
• 16
• 17
• 18
• 19
• 20
• 21
• 22

FormData 对象方法介绍

FormData 除了上面的建立新对象时直接将 form 做为参数传入外，还有其余的功能。网上大部分关于 FormData 介绍的文章都只提到了append()方法，那么FormData 对象到底有些什么方法呢？咱们console 一下就知道：

console 以后咱们有重大的发现，FormData 对象居然有这么方法，因此仍是本身测试才能发现真相，下面就对这些方法一一进行讲解：

一、append()

append()方法用于向 FormData 对象中添加键值对：

fd.append('key1',"value1"); fd.append('key2',"value2");

• 1
• 2

fd是 FormData 对象，能够新建的空的对象，也能够是已经包含 form 表单或其余键值对。

二、set()

设置对应的键 key 对应的值 value(s)

fd.set('key1',"value1"); fd.set('key2',"value2");

• 1
• 2

看起来跟append() 方法有点相似，这二者的区别就是，当指定的 key 值存在时，append()方法是将新增的添加的因此的键值对最后，而set()方法将会覆盖前面的设置的键值对。仍是经过实例来对比，咱们在前面的 form 的基础上 append() 或 set() 新的键值对：

fd.append('name',"will");

• 1

有两个key为name的键值对： 

fd.set('name',"will");

• 1

只有一个key为name的键值对： 

以上就是 append() 和 set() 的区别。若是设置的key值不存在，那么二者的效果是同样的。

三、delete()

接收一个参数，表示你要删除的 key 值的名字，若是有多个相同 key 值，会一并删除：

fd.append('name','will'); fd.delete('name');

• 1
• 2

form 中的 name 信息以及经过append() 新增的name 的信息都被删除了。

四、get() 和 getAll()

接收一个参数，表示须要查找的 key 的名称，返回第一个该 key 对应的 value 值。若是有多个相同的 key， 并且要返回全部的这个 key 对应的 value 值。

一样以上面的 form 表单为基础：

fd.append('name','will'); console.log(fd.get('name')); // sean

• 1
• 2

fd.append('name','will'); console.log(fd.getAll('name')); // ["sean", "will"]

• 1
• 2

五、has()

该方法也接收一个参数，一样是 key 的名称，返回一个Boolean 值， 用来判断FormData 对象是否含有该 key。以上面的form为例：

console.log(fd.has('name')); // true console.log(fd.has('Name')); // false

• 1
• 2

六、keys()

该方法不须要接收参数，返回一个迭代器，经过这个迭代器，咱们能够遍历FormData 对象中全部的 key。以上面的form为例：

for (var key of fd.keys()) { console.log(key); }

• 1
• 2
• 3

结果为：

name gender number photo

• 1
• 2
• 3
• 4

七、values()

有遍历 key 的迭代，固然也就少不了遍历 value 的迭代器了。values()就是遍历value 的迭代器，用法与 keys() 相似：

for (var value of fd.values()) { console.log(value); }

• 1
• 2
• 3

结果：

八、entries()

有遍历 key 的迭代器，也有遍历 value 的迭代器，为什么不搞一个二者一块儿的呢！entries()就是返回一个包含键值对的迭代器：

for(var pair of fd.entries()) { console.log(pair[0]+ ', '+ pair[1]); }

• 1
• 2
• 3

结果：

FormData兼容性问题

因为 FormData 是 XMLHttpRequest Level 2 新增的接口，如今 低于IE10 的IE浏览器不支持 FormData ，至于 上面介绍的 FormData 对象的方法通过测试，在 IE 浏览器中都不支持，具体的各大浏览器的支持状况能够参照下图：