XMLHttpRequest Level 2 使用指南_ZenDei技術網路在線

XMLHttpRequest是一個瀏覽器介面，使得Javascript可以進行HTTP(S)通信。最早，微軟在IE 5引進了這個介面。因為它太有用，其他瀏覽器也模仿部署了，ajax操作因此得以誕生。但是，這個介面一直沒有標準化，每家瀏覽器的實現或多或少有點不同。HTML 5的概念形成後，W3C開 ...

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