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 代碼。若是在請求失敗時是否執行其他的代碼可有可無，那麼可使用這個參數。

四、