XMLHttpRequest Level 2 使用指南

XMLHttpRequest是一個瀏覽器接口，使得Javascript能夠進行HTTP(S)通訊。

最先，微軟在IE 5引進了這個接口。由於它太有用，其餘瀏覽器也模仿部署了，ajax操做所以得以誕生。

可是，這個接口一直沒有標準化，每家瀏覽器的實現或多或少有點不一樣。HTML 5的概念造成後，W3C開始考慮標準化這個接口。2008年2月，就提出了XMLHttpRequest Level 2 草案。

這個XMLHttpRequest的新版本，提出了不少有用的新功能，將大大推進互聯網革新。本文就對這個新版本進行詳細介紹。

1、老版本的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：服務器返回的狀態文本。

2、老版本的缺點

* 只支持文本數據的傳送，沒法用來讀取和上傳二進制文件。

* 傳送和接收數據時，沒有進度信息，只能提示有沒有完成。

* 受到"同域限制"（Same Origin Policy），只能向同一域名的服務器請求數據。

3、新版本的功能

新版本的XMLHttpRequest對象，針對老版本的缺點，作出了大幅改進。

　　* 能夠設置HTTP請求的時限。

　　* 可使用FormData對象管理表單數據。

　　* 能夠上傳文件。

　　* 能夠請求不一樣域名下的數據（跨域請求）。

　　* 能夠獲取服務器端的二進制數據。

　　* 能夠得到數據傳輸的進度信息。

4、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還不支持。

5、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);

6、上傳文件

新版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);

7、跨域資源共享（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》。

8、接收二進制數據（方法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區段。

9、進度信息

新版本的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事件：傳輸結束，可是不知道成功仍是失敗。

10、閱讀材料

　　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設置。