DIV CSS 佈局教程網

Ajax 的 GET 與 POST 封裝,以及中文亂碼的完整排查
編輯:AJAX基礎知識     

Ajax 請求寫久了會發現,每個專案都在重寫同樣的東西:建立 XHR、判斷 readyState、拼字串、編碼。把它包成函式,之後就乾淨多了。這篇整理 GET 與 POST 兩種封裝,並把中文亂碼的成因一次講清楚。

建立 XHR 物件

return window.ActiveXObject
  ? new window.ActiveXObject('Microsoft.XMLHTTP')
  : new XMLHttpRequest;

這個物件有一個 onreadystatechange 事件,搭配 readyState 與 status 兩個屬性,就足夠應付大部分需求。

GET 方法的封裝

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"]。

POST 方法的封裝

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() 送出的資料。

亂碼從哪裡來

上面其實已經埋了兩個地雷,再加上編碼問題,常見的狀況有三種:

  1. 參數沒編碼就直接傳。各瀏覽器行為不一,IE 在傳送中文時尤其容易出問題。
  2. POST 沒設 Content-Type。伺服器端拿不到 send() 送出的內容。
  3. 請求頁與被請求頁的編碼不一致。

三個編碼函式的差別

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 通常會自動處理,不必手動指定。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved