try{
newActiveXObject(versions[i]);
arguments.callee.activeXString=versions[i];
break;
}catch(ex){
//跳过
}
}
}
returnnewActiveXObject(arguments.callee.activeXString);
}else{
thrownewError("NoXHRobjectavailable.");
}
}
这个函数中新增的代码首先检测原生XHR对象是否存在,如果存在则返回它的新实例。
如果原生对象不存在,则检测ActiveX对象。
如果这两种对象都不存在,就抛出一个错误。
然后,就可以使用下面的代码在所有浏览器中创建XHR对象了。
varxhr=createXHR();
1
XHR的用法
在使用XHR对象时,要调用的第一个方法是open(),它接受3个参数:
要发送的请求的类型(“get”、”post”等)、请求的URL和表示是否异步发送请求的布尔值。
xhr.open("get","example.php",false);
1
这行代码会启动一个针对example.php的GET请求。
有关这行代码,需要说明两点:
一是URL是相对于执行代码的当前页面(当然也可以使用绝对路径);二是调用open()方法并不会真正发送请求,而只是启动一个请求以备发送。
要发送特定的请求,必须像下面这样调用send()方法:
xhr.open("get","example.txt",false);
xhr.send(null);
这里的send()方法接收一个参数,即要作为请求主体发送的数据。
如果不需要通过请求主体发送数据,则必须传入null,因为这个参数对有些浏览器来说是必需的。
调用send()之后,请求就会被分派到服务器。
由于这次请求是同步的,JavaScript代码会等到服务器响应之后再继续执行。
在收到响应后,响应的数据会自动填充XHR对象的属性,相关的属性简介如下:
responseText:
作为响应主体被返回的文本。
responseXML:
如果响应的内容类型是”text/xml”或”application/xml”,这个属性中将保存包含着响应数据的XMLDOM文档。
status:
响应的HTTP状态。
statusText:
HTTP状态的说明。
xhr.open("get","example.txt",false);
xhr.send(null);
if((xhr.status>=200&&xhr.status<300)||xhr.status==304){
alert(xhr.responseText);
}else{
alert("Requestwasunsuccessful:
"+xhr.status);
}
在接收到响应后,第一步是检查status属性,以确定响应已经成功返回。
一般来说,可以将HTTP状态代码为200作为成功的标志。
此时,responseText属性的内容已经就绪,而且在内容类型正确的情况下,responseXML也应该能够访问了。
此外,状态代码为304表示请求的资源并没有被修改,可以直接使用浏览器中缓存的版本;当然,也意味着响应是有效的。
根据返回的状态代码,这个例子可能会显示由服务器返回的内容,也可能会显示一条错误消息。
我们建议读者要通过检测status来决定下一步的操作,不要依赖statusText,因为后者在跨浏览器使用时不太可靠。
另外,无论内容类型是什么,响应主体的内容都会保存到responseText属性中;而对于非XML数据而言,responseXML属性的值将为null。
像前面这样发送同步请求当然没有问题,但多数情况下,我们还是要发送异步请求,才能让JavaScript继续执行而不必等待响应。
此时,可以检测XHR对象的readyState属性,该属性表示请求/响应过程的当前活动阶段。
这个属性可取的值如下:
0:
未初始化。
尚未调用open()方法。
1:
启动。
已经调用open()方法,但尚未调用send()方法。
2:
发送。
已经调用send()方法,但尚未接收到响应。
3:
接收。
已经接收到部分响应数据。
4:
完成。
已经接收到全部响应数据,而且已经可以在客户端使用了。
只要readyState属性的值由一个值变成另一个值,都会触发一次readystatechange事件。
可以利用这个事件来检测每次状态变化后readyState的值。
通常,我们只对readyState值为4的阶段感兴趣,因为这时所有数据都已经就绪。
不过,必须在调用open()之前指定onreadystatechange事件处理程序才能确保跨浏览器兼容性。
下面来看一个例子。
varxhr=createXHR();
xhr.onreadystatechange=function(){
if(xhr.readyState==4){
if((xhr.status>=200&&xhr.status<300)||xhr.status==304){
alert(xhr.responseText);
}else{
alert("Requestwasunsuccessful:
"+xhr.status);
}
}
};
xhr.open("get","example.txt",true);
xhr.send(null);
以上代码利用DOM0级方法为XHR对象添加了事件处理程序,原因是并非所有浏览器都支持DOM2级方法。
与其他事件处理程序不同,这里没有向onreadystatechange事件处理程序中传递event对象;必须通过XHR对象本身来确定下一步该怎么做。
另外,在接收到响应之前还可以调用abort()方法来取消异步请求,如下所示:
xhr.abort();
1
调用这个方法后,XHR对象会停止触发事件,而且也不再允许访问任何与响应有关的对象属性。
在终止请求之后,还应该对XHR对象进行解引用操作。
由于内存原因,不建议重用XHR对象。
HTTP头部信息
每个HTTP请求和响应都会带有相应的头部信息。
默认情况下,在发送XHR请求的同时,还会发送下列头部信息。
Accept:
浏览器能够处理的内容类型。
Accept-Charset:
浏览器能够显示的字符集。
Accept-Encoding:
浏览器能够处理的压缩编码。
Accept-Language:
浏览器当前设置的语言。
Connection:
浏览器与服务器之间连接的类型。
Cookie:
当前页面设置的任何Cookie。
Host:
发出请求的页面所在的域。
Referer:
发出请求的页面的URI。
注意,HTTP规范将这个头部字段拼写错了,而为保证与规范一致,也只能将错就错了。
(这个英文单词的正确拼法应该是referrer。
)
User-Agent:
浏览器的用户代理字符串。
使用setRequestHeader()方法可以设置自定义的请求头部信息。
这个方法接受两个参数:
头部字段的名称和头部字段的值。
要成功发送请求头部信息,必须在调用open()方法之后且调用send()方法之前调用setRequestHeader():
varxhr=createXHR();
xhr.onreadystatechange=function(){
if(xhr.readyState==4){
if((xhr.status>=200&&xhr.status<300)||xhr.status==304){
alert(xhr.responseText);
}else{
alert("Requestwasunsuccessful:
"+xhr.status);
}
}
};
xhr.open("get","example.php",true);
xhr.setRequestHeader("MyHeader","MyValue");
xhr.send(null);
服务器在接收到这种自定义的头部信息之后,可以执行相应的后续操作。
我们建议读者使用自定义的头部字段名称,不要使用浏览器正常发送的字段名称,否则有可能会影响服务器的响应。
有的浏览器允许开发人员重写默认的头部信息,但有的浏览器则不允许这样做。
调用XHR对象的getResponseHeader()方法并传入头部字段名称,可以取得相应的响应头部信息。
而调用getAllResponseHeaders()方法则可以取得一个包含所有头部信息的长字符串。
varmyHeader=xhr.getResponseHeader("MyHeader");
varallHeaders=xhr.getAllResponseHeaders();
在服务器端,也可以利用头部信息向浏览器发送额外的、结构化的数据。
在没有自定义信息的情况下,getAllResponseHeaders()方法通常会返回如下所示的多行文本内容:
Date:
Sun,14Nov200418:
04:
03GMT
Server:
Apache/1.3.29(Unix)
Vary:
Accept
X-Powered-By:
PHP/4.3.8
Connection:
close
Content-Type:
text/html;charset=iso-8859-1
GET请求
GET是最常见的请求类型,最常用于向服务器查询某些信息。
必要时,可以将查询字符串参数追加到URL的末尾,以便将信息发送给服务器。
对XHR而言,位于传入open()方法的URL末尾的查询字符串必须经过正确的编码才行。
使用GET请求经常会发生的一个错误,就是查询字符串的格式有问题。
查询字符串中每个参数的名称和值都必须使用encodeURIComponent()进行编码,然后才能放到URL的末尾;而且所有名-值对儿都必须由和号(&)分隔:
xhr.open("get","example.php?
name1=value1&name2=value2",true);
1
下面这个函数可以辅助向现有URL的末尾添加查询字符串参数:
functionaddURLParam(url,name,value){
url+=(url.indexOf("?
")==-1?
"?
":
"&");
url+=encodeURIComponent(name)+"="+encodeURIComponent(value);
returnurl;
}
//howtouse
varurl="example.php";
//添加参数
url=addURLParam(url,"name","Nicholas");
url=addURLParam(url,"book","ProfessionalJavaScript");
//初始化请求
xhr.open("get",url,false);
POST请求
使用频率仅次于GET的是POST请求,通常用于向服务器发送应该被保存的数据。
POST请求应该把数据作为请求的主体提交,而GET请求传统上不是这样。
POST请求的主体可以包含非常多的数据,而且格式不限。
在open()方法第一个参数的位置传入”post”,就可以初始化一个POST请求。
发送POST请求的第二步就是向send()方法中传入某些数据。
由于XHR最初的设计主要是为了处理XML,因此可以在此传入XMLDOM文档,传入的文档经序列化之后将作为请求主体被提交到服务器。
当然,也可以在此传入任何想发送到服务器的字符串。
默认情况下,服务器对POST请求和提交Web表单的请求并不会一视同仁。
因此,服务器端必须有程序来读取发送过来的原始数据,并从中解析出有用的部分。
不过,我们可以使用XHR来模仿表单提交:
首先将Content-Type头部信息设置为application/x-www-form-urlencoded,也就是表单提交时的内容类型,其次是以适当的格式创建一个字符串。
functionsubmitData(){
varxhr=createXHR();
xhr.onreadystatechange=function(){
if(xhr.readyState==4){
if((xhr.status>=200&&xhr.status<300)||xhr.status==304){
alert(xhr.responseText);
}else{
alert("Requestwasunsuccessful:
"+xhr.status);
}
}
};
xhr.open("post","postexample.php",true);
xhr.setRequestHeader("Content-Type","application/x-www-form-urlencoded");
varform=document.getElementById("user-info");
xhr.send(serialize(form));
}
这个函数可以将ID为”user-info”的表单中的数据序列化之后发送给服务器。
XMLHttpRequest2级
鉴于XHR已经得到广泛接受,成为了事实标准,W3C也着手制定相应的标准以规范其行为。
XMLHttpRequest1级只是把已有的XHR对象的实现细节描述了出来。
而XMLHttpRequest2级则进一步发展了XHR。
并非所有浏览器都完整地实现了XMLHttpRequest2级规范,但所有浏览器都实现了它规定的部分内容。
FormData
现代Web应用中频繁使用的一项功能就是表单数据的序列化,XMLHttpRequest2级为此定义了FormData类型。
FormData为序列化表单以及创建与表单格式相同的数据(用于通过XHR传输)提供了便利。
下面的代码创建了一个FormData对象,并向其中添加了一些数据:
vardata=newFormData();
data.append("name","Nicholas");//这个append()方法接收两个参数:
键和值,分别对应表单字段的名字和字段中包含的值。
而通过向FormData构造函数中传入表单元素,也可以用表单元素的数据预先向其中填入键值对儿:
vardata=newFormData(document.forms[0]);
1
创建了FormData的实例后,可以将它直接传给XHR的send()方法。
xhr.open("post","postexample.php",true);
varform=document.getElementById("user-info");
xhr.send(newFormData(form));
支持FormData的浏览器有Firefox4+、Safari5+、Chrome和Android3+版WebKit。
超时设定
IE8为XHR对象添加了一个timeout属性,表示请求在等待响应多少毫秒之后就终止。
在给timeout设置一个数值后,如果在规定的时间内浏览器还没有接收到响应,那么就会触发timeout事件,进而会调用ontimeout事件处理程序。
这项功能后来也被收入了XMLHttpRequest2级规范中。
varxhr=createXHR();
xhr.onreadystatechange=function(){
if(xhr.readyState==4){
try{
if((xhr.status>=200&&xhr.status<300)||xhr.status==304){
alert(xhr.responseText);
}else{
alert("Requestwasunsuccessful:
"+xhr.status);
}
}catch(ex){
//假设由ontimeout事件处理程序处理
}
}
};
xhr.open("get","timeout.php",true);
xhr.timeout=1000;//将超时设置为1秒钟(仅适用于IE8+)
xhr.ontimeout=function(){
alert("Requestdidnotreturninasecond.");
};
xhr.send(null);
这个例子示范了如何使用timeout属性。
将这个属性设置为1000毫秒,意味着如果请求在1秒钟内还没有返回,就会自动终止。
请求终止时,会调用ontimeout事件处理程序。
但此时readyState可能已经改变为4了,这意味着会调用onreadystatechange事件处理程序。
可是,如果在超时终止请求之后再访问status属性,就会导致错误。
为避免浏览器报告错误,可以将检查status属性的语句封装在一个try-catch语句当中。
到2012年,IE8+是唯一支持超时设定的浏览器。
overrideMimeType()方法
Firefox最早引入了overrideMimeType()方法,用于重写XHR响应的MIME类型。
这个方法后来也被纳入了XMLHttpRequest2级规范。
tips:
MIME(MultipurposeInternetMailExtensions)多用途互联网邮件扩展类型。
是设定某种扩展名的文件用一种应用程序来打开的方式类型,当该扩展名文件被访问的时候,浏览器会自动使用指定应用程序来打开。
多用于指定一些客户端自定义的文件名,以及一些媒体文件打开方式。
1
因为返回响应的MIME类型决定了XHR对象如何处理它,所以提供一种方法能够重写服务器返回的MIME类型是很有用的。
比如,服务器返回的MIME类型是text/plain,但数据中实际包含的是XML。
根据MIME类型,即使数据是XML,responseXML属性中仍然是null。
通过调用overrideMimeType()方法,可以保证把响应当作XML而非纯文本来处理。
varxhr=createXHR();
xhr.open("get","text.php",true);
xhr.overrideMimeType("text/xml");
xhr.send(null);
这个例子强迫XHR对象将响应当作XML而非纯文本来处理。
调用overrideMimeType()必须在send()方法之前,才能保证重写响应的MIME类型。
支持overrideMimeType()方法的浏览器有Firefox、Safari4+、Opera10.5和Chrome。
进度事件
ProgressEvents规范是W3C的一个工作草案,定义了与客户端服务器通信有关的事件。
这些事件最早其实只针对XHR操作,但目前也被其他API借鉴。
有以下6个进度事件:
loadstart:
在接收到响应数据的第一个字节时触发。
progress:
在接收响应期间持续不断地触发。
error:
在请求发生错误时触发。
abort:
在因为调用abort()方法而终止连接时触发。
load:
在接收到完整的响应数据时触发。
loadend:
在通信完成或者触发error、abort或load事件后触发。
每个请求都从触发loadstart事件开始,接下来是一或多个progress事件,然后触发error、abort或load事件中的一个,最后以触发loadend事件结束。
支持前5个事件的浏览器有Firefox3.5+、Safari4+、Chrome、iOS版Safari和Android版WebKit。
Opera(从第11版开始)、IE8+只支持load事件。
目前还没有浏览器支持loadend事件(囧)。
load事件
varxhr=createXHR();
xhr.onload=function(){
if((xhr