XMLHttpRequest Level 2 使用指南
XMLHttpRequest 是一个浏览器接口,使得 Javascript 可以进行 HTTP (S) 通信。
最早,微软在 IE 5 引进了这个接口。因为它太有用,其他浏览器也模仿部署了,ajax 操作因此得以诞生。
但是,这个接口一直没有标准化,每家浏览器的实现或多或少有点不同。HTML 5 的概念形成后,W3C 开始考虑标准化这个接口。2008年 2 月,就提出了 XMLHttpRequest Level 2 草案。
这个 XMLHttpRequest 的新版本,提出了很多有用的新功能,将大大推动互联网革新。本文就对这个新版本进行详细介绍。
一、老版本的 XMLHttpRequest 对象
在介绍新版本之前,我们先回顾一下老版本的用法。
首先,新建一个 XMLHttpRequest 的实例。
var xhr = new XMLHttpRequest ();
然后,向远程主机发出一个 HTTP 请求。
xhr.open ('GET', 'example.php'); xhr.send ();
接着,就等待远程主机做出回应。这时需要监控 XMLHttpRequest 对象的状态变化,指定回调函数。
xhr.onreadystatechange = function (){ if ( xhr.readyState == 4 && xhr.status == 200 ) { alert ( xhr.responseText ); } else { alert ( xhr.statusText ); } };
上面的代码包含了老版本 XMLHttpRequest 对象的主要属性:
* xhr.readyState:XMLHttpRequest 对象的状态,等于 4 表示数据已经接收完毕。
* xhr.status:服务器返回的状态码,等于 200 表示一切正常。
* xhr.responseText:服务器返回的文本数据
* xhr.responseXML:服务器返回的 XML 格式的数据
* xhr.statusText:服务器返回的状态文本。
二、老版本的缺点
老版本的 XMLHttpRequest 对象有以下几个缺点:
* 只支持文本数据的传送,无法用来读取和上传二进制文件。
* 传送和接收数据时,没有进度信息,只能提示有没有完成。
* 受到"同域限制"(Same Origin Policy),只能向同一域名的服务器请求数据。
三、新版本的功能
新版本的 XMLHttpRequest 对象,针对老版本的缺点,做出了大幅改进。
* 可以设置 HTTP 请求的时限。
* 可以使用 FormData 对象管理表单数据。
* 可以上传文件。
* 可以请求不同域名下的数据(跨域请求)。
* 可以获取服务器端的二进制数据。
* 可以获得数据传输的进度信息。
下面,我就一一介绍这些新功能。
四、HTTP 请求的时限
有时,ajax 操作很耗时,而且无法预知要花多少时间。如果网速很慢,用户可能要等很久。
新版本的 XMLHttpRequest 对象,增加了 timeout 属性,可以设置 HTTP 请求的时限。
xhr.timeout = 3000;
上面的语句,将最长等待时间设为 3000 毫秒。过了这个时限,就自动停止 HTTP 请求。与之配套的还有一个 timeout 事件,用来指定回调函数。
xhr.ontimeout = function (event){ alert ('请求超时!'); }
目前,Opera、Firefox 和 IE 10 支持该属性,IE 8 和 IE 9 的这个属性属于 XDomainRequest 对象,而 Chrome 和 Safari 还不支持。
五、FormData 对象
ajax 操作往往用来传递表单数据。为了方便表单处理,HTML 5 新增了一个 FormData 对象,可以模拟表单。
首先,新建一个 FormData 对象。
var formData = new FormData ();
然后,为它添加表单项。
formData.append ('username', '张三'); formData.append ('id', 123456);
最后,直接传送这个 FormData 对象。这与提交网页表单的效果,完全一样。
xhr.send (formData);
FormData 对象也可以用来获取网页表单的值。
var form = document.getElementById ('myform'); var formData = new FormData (form); formData.append ('secret', '123456'); // 添加一个表单项 xhr.open ('POST', form.action); xhr.send (formData);
六、上传文件
新版 XMLHttpRequest 对象,不仅可以发送文本信息,还可以上传文件。
假定 files 是一个"选择文件"的表单元素(input[type="file"]),我们将它装入 FormData 对象。
var formData = new FormData (); for (var i = 0; i < files.length;i++) { formData.append ('files[]', files[i]); }
然后,发送这个 FormData 对象。
xhr.send (formData);
七、跨域资源共享(CORS)
新版本的 XMLHttpRequest 对象,可以向不同域名的服务器发出 HTTP 请求。这叫做"跨域资源共享"(Cross-origin resource sharing,简称 CORS)。
使用"跨域资源共享"的前提,是浏览器必须支持这个功能,而且服务器端必须同意这种"跨域"。如果能够满足上面的条件,则代码的写法与不跨域的请求完全一样。
xhr.open ('GET', 'http://other.server/and/path/to/script');
目前,除了 IE 8 和 IE 9,主流浏览器都支持 CORS,IE 10 也将支持这个功能。服务器端的设置,请参考《Server-Side Access Control》。
八、接收二进制数据(方法A:改写 MIMEType)
老版本的 XMLHttpRequest 对象,只能从服务器取回文本数据(否则它的名字就不用 XML 起首了),新版则可以取回二进制数据。
这里又分成两种做法。较老的做法是改写数据的 MIMEType,将服务器返回的二进制数据伪装成文本数据,并且告诉浏览器这是用户自定义的字符集。
xhr.overrideMimeType ("text/plain; charset=x-user-defined");
然后,用 responseText 属性接收服务器返回的二进制数据。
var binStr = xhr.responseText;
由于这时,浏览器把它当做文本数据,所以还必须再一个个字节地还原成二进制数据。
for (var i = 0, len = binStr.length; i < len; ++i) { var c = binStr.charCodeAt (i); var byte = c & 0xff; }
最后一行的位运算"c & 0xff",表示在每个字符的两个字节之中,只保留后一个字节,将前一个字节扔掉。原因是浏览器解读字符的时候,会把字符自动解读成 Unicode 的 0xF700-0xF7ff 区段。
八、接收二进制数据(方法B:responseType 属性)
从服务器取回二进制数据,较新的方法是使用新增的 responseType 属性。如果服务器返回文本数据,这个属性的值是"TEXT",这是默认值。较新的浏览器还支持其他值,也就是说,可以接收其他格式的数据。
你可以把 responseType 设为 blob,表示服务器传回的是二进制对象。
var xhr = new XMLHttpRequest (); xhr.open ('GET', '/path/to/image.png'); xhr.responseType = 'blob';
接收数据的时候,用浏览器自带的 Blob 对象即可。
var blob = new Blob ([xhr.response], {type: 'image/png'});
注意,是读取 xhr.response,而不是 xhr.responseText。
你还可以将 responseType 设为 arraybuffer,把二进制数据装在一个数组里。
var xhr = new XMLHttpRequest (); xhr.open ('GET', '/path/to/image.png'); xhr.responseType = "arraybuffer";
接收数据的时候,需要遍历这个数组。
var arrayBuffer = xhr.response; if (arrayBuffer) { var byteArray = new Uint8Array (arrayBuffer); for (var i = 0; i < byteArray.byteLength; i++) { // do something } }
更详细的讨论,请看 Sending and Receiving Binary Data。
九、进度信息
新版本的 XMLHttpRequest 对象,传送数据的时候,有一个 progress 事件,用来返回进度信息。
它分成上传和下载两种情况。下载的 progress 事件属于 XMLHttpRequest 对象,上传的 progress 事件属于 XMLHttpRequest.upload 对象。
我们先定义 progress 事件的回调函数。
xhr.onprogress = updateProgress; xhr.upload.onprogress = updateProgress;
然后,在回调函数里面,使用这个事件的一些属性。
function updateProgress (event) { if (event.lengthComputable) { var percentComplete = event.loaded / event.total; } }
上面的代码中,event.total 是需要传输的总字节,event.loaded 是已经传输的字节。如果 event.lengthComputable 不为真,则 event.total 等于0。
与 progress 事件相关的,还有其他五个事件,可以分别指定回调函数:
* load 事件:传输成功完成。
* abort 事件:传输被用户取消。
* error 事件:传输中出现错误。
* loadstart 事件:传输开始。
* loadEnd 事件:传输结束,但是不知道成功还是失败。
十、阅读材料
1. Introduction to XMLHttpRequest Level 2: 新功能的综合介绍。
2. New Tricks in XMLHttpRequest 2:一些用法的介绍。
3. Using XMLHttpRequest:一些高级用法,主要针对 Firefox 浏览器。
4. HTTP Access Control:CORS 综述。
5. DOM access control using cross-origin resource sharing:CORS 的 9 种 HTTP 头信息
6. Server-Side Access Control:服务器端 CORS 设置。
7. Enable CORS:服务端 CORS 设置。