本文分析一個實作中常見的問題:AJAX 的回呼函數需要參數,但 jQuery 的 success 設定只接受函數參考,參數該從哪裡傳進去,供需要的朋友參考。
在 JavaScript 中,特別是 AJAX 相關程式碼裡,回呼函數常常就是一個函數名,而設定物件中沒有地方塞參數。像下面這段:
var callback = function(p1){
//do something
}
var ajaxSetting = {
url: url,
timeout: me.timeout,
type: method,
contentType: "application/json",
dataType: "json",
cache: false,
async: async,
data: p_data,
success: callback,
error: function(p_request, p_status, p_err) { }
};
success 指向 callback,但 callback 需要一個參數 p1。jQuery 呼叫 success 時只會傳入回應資料,不會幫你補上 p1,於是 p1 永遠是 undefined。
success: function(result){
callback(p1_actual);
}
其中 p1_actual 是已知的值,也可以是函數本身。這一步能成立的原因是閉包:匿名函數在建立時捕獲了外層作用域的 p1_actual,等到 AJAX 完成、匿名函數被呼叫時,該變數仍在記憶體中。
做法一:用 bind 預綁參數。
success: callback.bind(null, p1_actual)
bind 的第一個參數是 this(這裡傳 null),之後依序是預先綁定的引數。呼叫時 jQuery 傳入的 result 會接在後面,因此 callback 收到的參數順序是 (p1_actual, result)。
做法二:用解構式回呼(ES2015 起的常見寫法)。
const makeCallback = (p1) => (result) => {
// 這裡同時拿得到 p1 與 result
};
$.ajax({ url, success: makeCallback(p1_actual) });
這個「回傳函數的函數」寫法語意最清楚,也最容易測試。
做法三:改用 async/await,乾脆不用回呼。
async function load(p1) {
try {
const res = await fetch(url);
if (!res.ok) throw new Error(`HTTP ${res.status}`);
const result = await res.json();
return callback(p1, result);
} catch (err) {
console.error('載入失敗:', err);
}
}
改成 await 之後,參數就是普通函數引數,錯誤處理也不必再嵌在 error 設定裡,整段邏輯讀起來是線性的。
若這個 AJAX 呼叫寫在迴圈裡,直接用迴圈變數會踩坑:
// 錯:三個請求都會傳入 3
for (var i = 0; i < 3; i++) {
$.ajax({ url, success: function(){ callback(i); } });
}
// 對:改用 let,每次迭代有獨立綁定
for (let i = 0; i < 3; i++) {
$.ajax({ url, success: function(){ callback(i); } });
}
這正是前面提到「用匿名函數包一層」時最容易被忽略的地方:閉包捕獲的是變數本身,不是當時的值。
原始 ajaxSetting 物件的語法有誤——success 之後的 error 前面少了一個逗號。正確寫法:
var ajaxSetting = {
url: url,
timeout: me.timeout,
type: method,
contentType: "application/json",
dataType: "json",
cache: false,
async: async,
data: p_data,
success: callback,
error: function (p_request, p_status, p_err) {
console.error('請求失敗:', p_status, p_err);
}
};
另外提醒,jQuery 自 1.8 起已把 $.ajax 的 success/error 標記為不建議使用,建議改用 done/fail/always 或直接 await。若專案已全面改用 fetch,就不需要再為回傳參數傷腦筋了。
希望本文所述對你的 JavaScript 學習有所幫助。