用 Ajax 的日子裡,真正卡住人的往往不是「怎麼發請求」,而是那些邊角問題:瀏覽器不相容、中文變亂碼、IE 死活讀快取、responseXML 拿不到東西。這篇把常見的坑整理成一份清單,遇到時可以直接對照。
Ajax 帶起了一整代 JavaScript 函式庫。對一般開發者而言,選一個順手的庫,等於一次解決跨瀏覽器、事件綁定、DOM 操作與動畫等一堆瑣事,開發也穩定得多。當年常被提到的輕量級選擇:
$ 這個簡寫最具代表性,script.aculo.us 就是建立在它之上。今天這四個已經多數退場,但結論沒變:不要為了幾個 Ajax 呼叫而手刻跨瀏覽器邏輯,能用的工具就用。
XMLHttpRequest 收送資料時預設使用 UTF-8。若前端頁面是 GB2312 或其他編碼,就會看到亂碼;POST 出去的資料同理,後端若不以 UTF-8 解讀也會出問題。解法有四條:
這是最根本也最省事的做法,國際化專案本來就該如此。
注意:只在 HTML 裡寫 meta 是沒用的,必須透過 HTTP header 送出。
PHP : header('Content-Type:text/html;charset=GB2312');
ASP : Response.Charset = "GB2312"
JSP : response.setHeader("Charset","GB2312");
當你透過 Ajax 抓的是靜態檔、根本無法自行送出 header 時,就在伺服器端統一設定。以 Apache 為例:
AddDefaultCharset GB2312
這裡有個額外的坑:靜態檔通常會經過 Apache 的 deflate 或 gzip 壓縮。在这种情況下,IE 第一次用 XMLHttpRequest 抓的內容顯示正常,第二次卻變亂碼——因為第二次讀的是快取,而瀏覽器解壓縮的環節可能把伺服器設定的預設編碼宣告弄丟了。若無法禁止快取,可以改成讓這個文字檔不壓縮來避開。
非 UTF-8 的頁面,在寫出 Ajax 取得的文字前先轉成 Unicode(或直接把資料以 UTF-8 編碼輸出),也能正常顯示。
IE 的快取機制會讓 XMLHttpRequest 拜訪同一個動態網址時,回傳第一次的內容。典型症狀是:刪除一筆資料、復原、再刪一次——第二次卻沒反應,得等一段時間才好。有兩種解法。
var url = 'https://dancewithnet.com/';
url += (url.indexOf("?") > -1 ? "&" : "?") + "t=" + new Date().getTime();
// 或用 Math.random()
HTML meta 寫法(效果不如伺服器端 header 可靠):
<meta http-equiv="pragma" content="no-cache" /> <meta http-equiv="Cache-Control" content="no-cache, must-revalidate" /> <meta http-equiv="expires" content="Thu, 01 Jan 1970 00:00:01 GMT" />
PHP:
header("Expires: Thu, 01 Jan 1970 00:00:01 GMT");
header("Cache-Control: no-cache, must-revalidate");
header("Pragma: no-cache");
ASP:
Response.expires = 0 Response.addHeader "pragma", "no-cache" Response.addHeader "Cache-Control", "no-cache, must-revalidate"
JSP:
response.addHeader("Cache-Control", "no-cache");
response.addHeader("Expires", "Thu, 01 Jan 1970 00:00:01 GMT");
IE 使用 responseXML 時,只認副檔名是 .xml 的資源。若你的動態頁是 .asp、.php,就算內容再怎麼像 XML 也拿不到 DOM。三種因應方式:
PHP : header("Content-Type:text/xml;charset=utf-8");
ASP : Response.ContentType = "text/xml"
JSP : response.setHeader("ContentType","text/xml");
responseText 取字串,自己封裝成 XML。雖然麻煩,但可控性最高。readyState == 4 而忽略 status == 200,遇到 404、500 時會把錯誤頁當正常內容寫進畫面。這些坑今天多半已被 fetch、CORS 規範與統一編碼的預設值填平,但清單本身的價值在於:遇到「資料明明對卻顯示不對」時,先懷疑編碼與快取;遇到「XML 解析不出來」時,先確認 Content-Type。這兩條經驗至今仍然管用。