jQuery 幫我們省下了大量冗長的元素選取與相容性程式碼,用起来順手,久之甚至會忘了底層在做什麼。但 jQuery 說到底就是對原生 API 的封裝,理解它的原理,才能在使用時做出正確判斷——例如何時該用 async: false、readyState 的每個階段代表什麼。
本文示範如何用原生 JavaScript 打造一個操作方式類似 jQuery $.ajax 的簡易版。
為了支援彈性傳參,我們採用物件形式,把設定與回呼混在一起傳入:
//data作為參數傳入我們下面封裝的函數 var data = { //數據 user:"yonghu1", pass:'12345', age:18, //回調函數 success:function (data){ alert(data); } }
function toData(obj){ if (obj == null){ return obj; } var arr = []; for (var i in obj){ var str = i+"="+obj[i]; arr.push(str); } return arr.join("&"); }
這個輔助函式把 {user:"yonghu1", pass:'12345'} 轉成 user=yonghu1&pass=12345,供 GET 的網址或 POST 的 body 使用。
實務上這裡有兩個必須補強的地方:一是值應該做 URL 編碼(encodeURIComponent),否則中文或含 &、= 的字元會破壞參數結構;二是用 for...in 遍歷物件時應加 hasOwnProperty 檢查,避免撈到原型鏈上的屬性。
function ajax(obj){ //指定提交方式的默認值 obj.type = obj.type || "get"; //設置是否異步,默認為true(異步) obj.async = obj.async || true; //設置數據的默認值 obj.data = obj.data || null; if (window.XMLHttpRequest){ //非ie var ajax = new XMLHttpRequest(); }else{ //ie var ajax = new ActiveXObject("Microsoft.XMLHTTP"); } //區分get和post if (obj.type == "post"){ ajax.open(obj.type,obj.url,obj.async); ajax.setRequestHeader("Content-Type", "application/x-www-form-urlencoded"); var data = toData(obj.data); ajax.send(data); }else{ //get test.php?xx=xx&aa=xx var url = obj.url+"?"+toData(obj.data); ajax.open(obj.type,url,obj.async); ajax.send(); } ajax.onreadystatechange = function (){ if (ajax.readyState == 4){ if (ajax.status>=200&&ajax.status<300 || ajax.status==304){ if (obj.success){ obj.success(ajax.responseText); } }else{ if (obj.error){ obj.error(ajax.status); } } } } }
建立請求物件。標準寫法是 new XMLHttpRequest();ActiveXObject("Microsoft.XMLHTTP") 是 IE6 時代的退路。今天的專案不必再寫這個分支。
GET 與 POST 的差異。GET 把參數拼在網址後面,send() 不帶內容;POST 則把參數放進 body,且必須先設定 Content-Type: application/x-www-form-urlencoded,否則後端收到的會是原始字串而非解析後的參數。
readyState 與 status。readyState 有 0 到 4 五個階段(未初始化、已連線、收到標頭、載入中、完成),只有在 4 時回應才完整。狀態碼方面,2xx 代表成功、304 代表命中瀏覽器快取也算可用,其餘(如 404、500)走 error 分支。
有幾點值得注意:範例中 obj.async = obj.async || true 永遠得到 true,無法真正關閉非同步;物件內部的區域變數 ajax 與函式名稱同名,容易誤讀;此外完全沒有處理網路層錯誤(onerror)與逾時(timeout)。
更重要的是:手寫 XHR 封裝在今天已無必要。原生 fetch 回傳 Promise,語法簡潔且能自然搭配 async/await:
const res = await fetch(url, { method: 'POST', body: data }); if (!res.ok) throw new Error(res.status); const json = await res.json();
需要攔截器、逾時、進度回報等完整功能時,Axios 是常見選擇。理解 XHR 封裝的價值在於除錯與理解底層,而非用於生產環境。