XMLHttpRequest Level 2 使用指南

標籤：orm   enable   介面   get   else   檔案   time   script   時間   

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：伺服器返回的狀態文本。

二、老版本的缺點

* 只支援文本資料的傳送，無法用來讀取和上傳二進位檔案。

* 傳送和接收資料時，沒有進度資訊，只能提示有沒有完成。

* 受到"同域限制"（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區段。

九、進度資訊

新版本的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設定。

XMLHttpRequest Level 2 使用指南