Ajax 請求寫久了會發現,每個專案都在重寫同樣的東西:建立 XHR、判斷 readyState、拼字串、編碼。把它包成函式,之後就乾淨多了。這篇整理 GET 與 POST 兩種封裝,並把中文亂碼的成因一次講清楚。
return window.ActiveXObject
? new window.ActiveXObject('Microsoft.XMLHTTP')
: new XMLHttpRequest;
這個物件有一個 onreadystatechange 事件,搭配 readyState 與 status 兩個屬性,就足夠應付大部分需求。
var get = function(url, b, callback){
var xmlhttp = createXMLHttp();
xmlhttp.onreadystatechange = function(){
if(xmlhttp.readyState == 4 && xmlhttp.status == 200){
callback(xmlhttp.responseText);
}
}
if(b != undefined){
var arr = [], e;
for(e in b){
arr.push(e + '=' + encodeURIComponent(b[e]));
// 實測:不使用 encodeURIComponent,IE8 下無法正確傳遞中文
}
url += '?' + arr.join('&');
}
xmlhttp.open('GET', url, true);
xmlhttp.send();
}
GET 的做法是把參數格式化(a=1&b=2)後附加在網址後面,伺服器端用取得 URL 參數的方式接收,例如 PHP 的 $_GET["a"]。
var ajax = function(a){
var xmlhttp = createXMLHttp();
xmlhttp.onreadystatechange = function(){
if(xmlhttp.readyState == 4 && xmlhttp.status == 200){
a.success(xmlhttp.responseText);
}else return xmlhttp;
}
xmlhttp.open('POST', a.url, true);
// POST 一定要設定這個標頭
xmlhttp.setRequestHeader("Content-type", "application/x-www-form-urlencoded");
var c = [];
for(var e in a.data){
c.push(e + '=' + encodeURIComponent(a.data[e]));
}
a.data = c.join('&');
xmlhttp.setRequestHeader("Content-length", c.length); // 選填
xmlhttp.setRequestHeader("Connection", "close"); // 選填
xmlhttp.send(a.data);
// 伺服器端用 POST 方式接收,例如 PHP 的 $_POST['a']
}
參數 a 是一個物件,形如 {url:"...", data:{a:1,b:2}, success:function(){}},分別對應網址、資料與成功後的回呼函式。
POST 和 GET 的差異有兩點:資料同樣要格式化成 a=1&b=2,但它是寫在 send() 裡而不是網址上;另外必須先設定 Content-Type。實測顯示,若不設為 application/x-www-form-urlencoded,伺服器端根本收不到 send() 送出的資料。
上面其實已經埋了兩個地雷,再加上編碼問題,常見的狀況有三種:
send() 送出的內容。JavaScript 裡有 escape、encodeURI、encodeURIComponent 三個編碼函式。前兩個對某些特殊字元並不會編碼,所以第三個才是比較好的選擇。不編碼就送出,各瀏覽器的表現可能不同,中文尤其容易出錯。
<!-- <meta http-equiv="Content-Type" content="text/html; charset=gb2312" /> -->
<!-- 實測:不使用上面的 meta 宣告 charset,在 IE 下會出現亂碼 -->
<!--
* header("Content-Type: text/html; charset=gb2312");
被呼叫的 AJAX 頁面使用了 gb2312 編碼,在 Chrome 下出現亂碼,
在 IE 下則正常
-->
這個問題很惱人,因為它的表現會隨瀏覽器與情境飄移,不容易重現與定位。
把請求頁與被請求頁的編碼都統一為 UTF-8,參數送出前一律編碼,就能有效避開絕大部分亂碼。這比逐案追查 charset 宣告與 header() 設定要務實得多。
補充一個實務細節:Content-length 若真要設定,應該用位元組長度而非字串長度,否則含中文時會算錯;現代的 fetch 與 XHR 通常會自動處理,不必手動指定。