XMLHttpRequest 对象

一、XMLHttpRequest 对象

　　XMLHttpRequest 对象提供了对 HTTP 协议的彻底的访问，包括作出 POST 和 HEAD 请求以及普通的 GET 请求的能力。XMLHttpRequest 能够同步或异步地返回 Web 服务器的响应，而且可以以文本或者一个 DOM 文档的形式返回内容。

尽管名为 XMLHttpRequest，它并不限于和 XML 文档一块儿使用：它能够接收任何形式的文本文档。

XMLHttpRequest 对象是名为AJAX 的 Web 应用程序架构的一项关键功能。

二、属性

　　2.1 readyState

　　HTTP 请求的状态.当一个 XMLHttpRequest 初次建立时，这个属性的值从 0 开始，直到接收到完整的 HTTP 响应，这个值增长到 4。

状态	名称	描述
0	Uninitialized	初始化状态。XMLHttpRequest 对象已建立或已被 abort() 方法重置。
1	Open	open() 方法已调用，可是 send() 方法未调用。请求尚未被发送。
2	Sent	Send() 方法已调用，HTTP 请求已发送到 Web 服务器。未接收到响应。
3	Receiving	全部响应头部都已经接收到。响应体开始接收但未完成。
4	Loaded	HTTP 响应已经彻底接收。

　　2.2 responseText

　　目前为止为服务器接收到的响应体（不包括头部），或者若是尚未接收到数据的话，就是空字符串。

　　若是 readyState 小于 3，这个属性就是一个空字符串。当 readyState 为 3，这个属性返回目前已经接收的响应部分。若是 readyState 为 4，这个属性保存了完整的响应体。

　　2.3 responseXML

　　对请求的响应

　　2.4status

　　由服务器返回的 HTTP 状态代码，如 200 表示成功，而 404 表示 "Not Found" 错误。当 readyState 小于 3 的时候读取这一属性会致使一个异常。

　　2.5statusText

　　这个属性用名称而不是数字指定了请求的 HTTP 的状态代码。也就是说，当状态为 200 的时候它是 "OK"，当状态为 404 的时候它是 "Not Found"。和 status 属性同样，当 readyState 小于 3 的时候读取这一属性会致使一个异常。

三、事件句柄

　　onreadystatechange

　　每次 readyState 属性改变的时候调用的事件句柄函数。当 readyState 为 3 时，它也可能调用屡次。

四、方法

　　4.1 abort()

　　取消当前响应，关闭链接而且结束任何未决的网络活动。

　　这个方法把 XMLHttpRequest 对象重置为 readyState 为 0 的状态，而且取消全部未决的网络活动。例如，若是请求用了太长时间，并且响应再也不必要的时候，能够调用这个方法。

　　4.2 getAllResponseHeaders()

　　把 HTTP 响应头部做为未解析的字符串返回。

　　若是 readyState 小于 3，这个方法返回 null。不然，它返回服务器发送的全部 HTTP 响应的头部。头部做为单个的字符串返回，一行一个头部。每行用换行符 "\r\n" 隔开。

　　4.3 getResponseHeader()

　　返回指定的 HTTP 响应头部的值。其参数是要返回的 HTTP 响应头部的名称。可使用任何大小写来制定这个头部名字，和响应头部的比较是不区分大小写的。

　　该方法的返回值是指定的 HTTP 响应头部的值，若是没有接收到这个头部或者 readyState 小于 3 则为空字符串。若是接收到多个有指定名称的头部，这个头部的值被链接起来并返回，使用逗号和空格分隔开各个头部的值。

　　4.4 open()

　　初始化 HTTP 请求参数，例如 URL 和 HTTP 方法，可是并不发送请求。

　　4.5 send()

　　发送 HTTP 请求，使用传递给 open() 方法的参数，以及传递给该方法的可选请求体。

　　4.6 setRequestHeader()

　　向一个打开但未发送的请求设置或添加一个 HTTP 请求。

---

XMLHttpRequest.open()

初始化 HTTP 请求参数

语法

open(method, url, async, username, password)

method 参数是用于请求的 HTTP 方法。值包括 GET、POST 和 HEAD。

url 参数是请求的主体。大多数浏览器实施了一个同源安全策略，而且要求这个 URL 与包含脚本的文本具备相同的主机名和端口。

async 参数指示请求使用应该异步地执行。若是这个参数是 false，请求是同步的，后续对 send() 的调用将阻塞，直到响应彻底接收。若是这个参数是 true 或省略，请求是异步的，且一般须要一个 onreadystatechange 事件句柄。

username 和 password 参数是可选的，为 url 所需的受权提供认证资格。若是指定了，它们会覆盖 url 本身指定的任何资格。

说明

这个方法初始化请求参数以供 send() 方法稍后使用。它把 readyState 设置为 1，删除以前指定的全部请求头部，以及以前接收的全部响应头部，而且把 responseText、responseXML、status 以及 statusText 参数设置为它们的默认值。当 readyState 为 0 的时候（当 XMLHttpRequest 对象刚建立或者 abort() 方法调用后）以及当 readyState 为 4 时（已经接收响应时），调用这个方法是安全的。当针对任何其余状态调用的时候，open() 方法的行为是为指定的。

除了保存供 send() 方法使用的请求参数，以及重置 XMLHttpRequest 对象以便复用，open() 方法没有其余的行为。要特别注意，当这个方法调用的时候，实现一般不会打开一个到 Web 服务器的网络链接。

---

 

XMLHttpRequest.send()

发送一个 HTTP 请求

语法

send(body)

若是经过调用 open() 指定的 HTTP 方法是 POST 或 PUT，body 参数指定了请求体，做为一个字符串或者 Document 对象。若是请求体不适必须的话，这个参数就为 null。对于任何其余方法，这个参数是不可用的，应该为 null（有些实现不容许省略该参数）。

说明

这个方法致使一个 HTTP 请求发送。若是以前没有调用 open()，或者更具体地说，若是 readyState 不是 1，send() 抛出一个异常。不然，它发送一个 HTTP 请求，该请求由如下几部分组成：

• 以前调用 open() 时指定的 HTTP 方法、URL 以及认证资格（若是有的话）。
• 以前调用 setRequestHeader() 时指定的请求头部（若是有的话）。
• 传递给这个方法的 body 参数。

一旦请求发布了，send() 把 readyState 设置为 2，并触发 onreadystatechange 事件句柄。

若是以前调用的 open() 参数 async 为 false，这个方法会阻塞并不会返回，直到 readyState 为 4 而且服务器的响应被彻底接收。不然，若是 async 参数为 true，或者这个参数省略了，send() 当即返回，而且正如后面所介绍的，服务器响应将在一个后台线程中处理。

若是服务器响应带有一个 HTTP 重定向，send() 方法或后台线程自动听从重定向。当全部的 HTTP 响应头部已经接收，send() 或后台线程把 readyState 设置为 3 并触发 onreadystatechange 事件句柄。若是响应较长，send() 或后台线程可能在状态 3 中触发 onreadystatechange 事件句柄：这能够做为一个下载进度指示器。最后，当响应完成，send() 或后台线程把 readyState 设置为 4，并最后一次触发事件句柄。

---

 

XMLHttpRequest.setRequestHeader()

语法

setRequestHeader(name, value)

name 参数是要设置的头部的名称。这个参数不该该包括空白、冒号或换行。

value 参数是头部的值。这个参数不该该包括换行。

说明

setRequestHeader() 方法指定了一个 HTTP 请求的头部，它应该包含在经过后续 send() 调用而发布的请求中。这个方法只有当 readyState 为 1 的时候才能调用，例如，在调用了 open() 以后，但在调用 send() 以前。

若是带有指定名称的头部已经被指定了，这个头部的新值就是：以前指定的值，加上逗号、空白以及这个调用指定的值。

若是 open() 调用指定了认证资格，XMLHttpRequest 自动发送一个适当的 Authorization 请求头部。可是，你可使用 setRequestHeader() 来添加这个头部。相似地，若是 Web 服务器已经保存了和传递给 open() 的 URL 相关联的 cookie，适当的 Cookie 或 Cookie2 头部也自动地包含到请求中。能够经过调用 setRequestHeader() 来把这些 cookie 添加到头部。XMLHttpRequest 也能够为 User-Agent 头部提供一个默认值。若是它这么作，你为该头部指定的任何值都会添加到这个默认值后面。

---

 

XMLHttpRequest 对象用于在后台与服务器交换数据。

一、建立 XMLHttpRequest 对象

xmlhttp=new XMLHttpRequest();

老版本的 Internet Explorer （IE5 和 IE6）使用 ActiveX 对象：

xmlhttp=new ActiveXObject("Microsoft.XMLHTTP");

二、异步

<script type="text/javascript">
var xmlhttp;
function loadXMLDoc(url)
{
xmlhttp=null;
if (window.XMLHttpRequest)
  {// code for all new browsers
  xmlhttp=new XMLHttpRequest();
  }
else if (window.ActiveXObject)
  {// code for IE5 and IE6
  xmlhttp=new ActiveXObject("Microsoft.XMLHTTP");
  }
if (xmlhttp!=null)
  {
  xmlhttp.onreadystatechange=state_Change;
  xmlhttp.open("GET",url,true);
  xmlhttp.send(null);
  }
else
  {
  alert("Your browser does not support XMLHTTP.");
  }
}

function state_Change()
{
if (xmlhttp.readyState==4)
  {// 4 = "loaded"
  if (xmlhttp.status==200)
    {// 200 = OK
    // ...our code here...
    }
  else
    {
    alert("Problem retrieving XML data");
    }
  }
}
</script>

三、同步

<script type="text/javascript">
var xmlhttp;
function loadXMLDoc(url)
{
xmlhttp=null;
if (window.XMLHttpRequest)
  {// code for IE7, Firefox, Opera, etc.
  xmlhttp=new XMLHttpRequest();
  }
else if (window.ActiveXObject)
  {// code for IE6, IE5
  xmlhttp=new ActiveXObject("Microsoft.XMLHTTP");
  }
if (xmlhttp!=null)
  {
  xmlhttp.open("GET",url,false);
  xmlhttp.send(null);
//our code here
  }
else
  {
  alert("Your browser does not support XMLHTTP.");
  }
}
</script>

注：为何使用 Async=true ？

True 表示脚本会在 send() 方法以后继续执行，而不等待来自服务器的响应。

onreadystatechange 事件使代码复杂化了。可是这是在没有获得服务器响应的状况下，防止代码中止的最安全的方法。

经过把该参数设置为 "false"，能够省去额外的 onreadystatechange 代码。若是在请求失败时是否执行其他的代码可有可无，那么可使用这个参数。

四、