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:伺服器返回的狀態文字。
二、老版本的缺點
老版本的XMLHttpRequest物件有以下幾個缺點:
* 只支援文字資料的傳送,無法用來讀取和上傳二進位制檔案。
* 傳送和接收資料時,沒有進度資訊,只能提示有沒有完成。
* 受到"同域限制"(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區段。
八、接收二進位制資料(方法B:responseType屬性)
從伺服器取回二進位制資料,較新的方法是使用新增的responseType屬性。如果伺服器返回文字資料,這個屬性的值是"TEXT",這是預設值。較新的瀏覽器還支援其他值,也就是說,可以接收其他格式的資料。
你可以把responseType設為blob,表示伺服器傳回的是二進位制物件。
var xhr = new XMLHttpRequest();
xhr.open('GET', '/path/to/image.png');
xhr.responseType = 'blob';
接收資料的時候,用瀏覽器自帶的Blob物件即可。
var blob = new Blob([xhr.response], {type: 'image/png'});
注意,是讀取xhr.response,而不是xhr.responseText。
你還可以將responseType設為arraybuffer,把二進位制資料裝在一個陣列裡。
var xhr = new XMLHttpRequest();
xhr.open('GET', '/path/to/image.png');
xhr.responseType = "arraybuffer";
接收資料的時候,需要遍歷這個陣列。
var arrayBuffer = xhr.response;
if (arrayBuffer) {
var byteArray = new Uint8Array(arrayBuffer);
for (var i = 0; i < byteArray.byteLength; i++) {
// do something
}
}
更詳細的討論,請看Sending and Receiving Binary Data。
九、進度資訊
新版本的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設定。
(完)