XMLHttpRequest 對象–AJAX的基礎

文章目錄

• 瀏覽器支援
• W3C 標準化
• readyState
• responseText
• status
• statusText
• onreadystatechange
• abort()
• getAllResponseHeaders()
• getResponseHeader()
• open()
• send()
• setRequestHeader()
• 文法
• 說明
• 文法
• 說明
• 文法
• 說明

XMLHttpRequest對象是AJAX的基礎，也在jQuery中作為底層的基礎應用。 

XMLHttpRequest 對象

XMLHttpRequest 對象提供了對 HTTP 協議的完全的訪問，包括做出 POST 和 HEAD 請求以及普通的 GET 請求的能力。XMLHttpRequest 可以同步或非同步地返回 Web 服務器的響應，並且能夠以文本或者一個 DOM 文檔的形式返回內容。

儘管名為 XMLHttpRequest，它並不限於和 XML 文檔一起使用：它可以接收任何形式的文字文件。

XMLHttpRequest 對象是名為 AJAX 的 Web 應用程式架構的一項關鍵功能。

瀏覽器支援

XMLHttpRequest 得到了所有現代瀏覽器較好的支援。唯一的瀏覽器依賴性涉及 XMLHttpRequest 對象的建立。在 IE 5 和 IE 6 中，必須使用特定於 IE 的 ActiveXObject() 建構函式。

W3C 標準化

XMLHttpRequest 對象還沒有標準化，但是 W3C 已經開始了標準化的工作，本手冊介紹的內容都是基於標準化的工作草案。

當前的 XMLHttpRequest 實現已經相當一致。但是和標準有細微的不同。例如，一個實現可能返回 null，而標準要求是Null 字元串，或者實現可能把 readyState 設定為 3 而不保證所有的回應標頭部都可用。

屬性readyState

HTTP 要求的狀態.當一個 XMLHttpRequest 初次建立時，這個屬性的值從 0 開始，直到接收到完整的 HTTP 響應，這個值增加到 4。

5 個狀態中每一個都有一個相關聯的非正式的名稱，下表列出了狀態、名稱和含義：

狀態	名稱	描述
0	Uninitialized	初始化狀態。XMLHttpRequest 對象已建立或已被 abort() 方法重設。
1	Open	open() 方法已調用，但是 send() 方法未調用。請求還沒有被發送。
2	Sent	Send() 方法已調用，HTTP 要求已發送到 Web 服務器。未接收到響應。
3	Receiving	所有回應標頭部都已經接收到。響應體開始接收但未完成。
4	Loaded	HTTP 響應已經完全接收。

readyState 的值不會遞減，除非當一個請求在處理過程中的時候調用了 abort() 或 open() 方法。每次這個屬性的值增加的時候，都會觸發 onreadystatechange 事件控制代碼。

responseText

目前為止為伺服器接收到的響應體（不包括頭部），或者如果還沒有接收到資料的話，就是Null 字元串。

如果 readyState 小於 3，這個屬性就是一個Null 字元串。當 readyState 為 3，這個屬性返回目前已經接收的響應部分。如果 readyState 為 4，這個屬性儲存了完整的響應體。

如果響應包含了為響應體指定字元編碼的頭部，就使用該編碼。否則，假定使用 Unicode UTF-8。

responseXML

對請求的響應，解析為 XML 並作為 Document 對象返回。

status

由伺服器返回的 HTTP 狀態碼，如 200 表示成功，而 404 表示 "Not Found" 錯誤。當 readyState 小於 3 的時候讀取這一屬性會導致一個異常。

statusText

這個屬性用名稱而不是數字指定了請求的 HTTP 的狀態碼。也就是說，當狀態為 200 的時候它是 "OK"，當狀態為 404 的時候它是 "Not Found"。和 status 屬性一樣，當 readyState 小於 3 的時候讀取這一屬性會導致一個異常。

事件控制代碼onreadystatechange

每次 readyState 屬性改變的時候調用的事件控制代碼函數。當 readyState 為 3 時，它也可能調用多次。

方法abort()

取消當前響應，關閉串連並且結束任何未決的網路活動。

這個方法把 XMLHttpRequest 對象重設為 readyState 為 0 的狀態，並且取消所有未決的網路活動。例如，如果請求用了太長時間，而且響應不再必要的時候，可以調用這個方法。

getAllResponseHeaders()

把 HTTP 回應標頭部作為未解析的字串返回。

如果 readyState 小於 3，這個方法返回 null。否則，它返回伺服器發送的所有 HTTP 響應的頭部。頭部作為單個的字串返回，一行一個頭部。每行用分行符號 "\r\n" 隔開。

getResponseHeader()

返回指定的 HTTP 回應標頭部的值。其參數是要返回的 HTTP 回應標頭部的名稱。可以使用任何大小寫來制定這個頭部名字，和回應標頭部的比較是不區分大小寫。

該方法的傳回值是指定的 HTTP 回應標頭部的值，如果沒有接收到這個頭部或者 readyState 小於 3 則為空白字串。如果接收到多個有指定名稱的頭部，這個頭部的值被串連起來並返回，使用逗號和空格分隔開各個頭部的值。

open()

初始化 HTTP 要求參數，例如 URL 和 HTTP 方法，但是並不發送請求。

send()

發送 HTTP 要求，使用傳遞給 open() 方法的參數，以及傳遞給該方法的可選請求體。

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 自動化佈建而不是由這個方法設定，以符合 HTTP 協議。這包括如下和代理相關的頭部：

• Host
• Connection
• Keep-Alive
• Accept-charset
• Accept-Encoding
• If-Modified-Since
• If-None-Match
• If-Range
• Range