DIV CSS 佈局教程網

AJAX 回呼函數如何傳入參數
編輯:關於JavaScript     

本文分析一個實作中常見的問題: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 學習有所幫助。

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