萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

jQuery AJAX 非同步回調無法賦值全域變數:原因深度解析與三種解決方案

問題現象

var result = 'initial';

$.ajax({
    url: '/api/data',
    success: function(data) {
        result = data; // 看似賦值成功
    }
});

console.log(result); // 輸出 'initial',而非 AJAX 回傳資料!

根本原因:非同步執行流程

  1. JS 是**單執行緒、事件循環** 模型。
  2. $.ajax 預設 async: true (非同步)。
  3. 呼叫 $.ajax 後,**立即執行下一行** (`console.log`),不等待伺服器回應。
  4. 稍後伺服器回應,**事件循環** 排程執行 success 回調,此時才修改 result。

時間軸視覺化:

T0: $.ajax 發送請求 → 立即返回,繼續執行
T1: console.log(result)  → 'initial'  (此時 success 尚未執行)
T2: (網路延遲...)
T3: 伺服器回應 → success 回調入隊
T4: 事件循環執行 success → result = data

三種解決方案

方案一:同步 AJAX (async: false) ⚠️ 不推薦

var result;
$.ajax({
    url: '/api/data',
    async: false, // 阻塞瀏覽器主執行緒直到完成
    success: function(data) {
        result = data;
    }
});
console.log(result); // 確保拿到資料

缺點:凍結 UI、違反現代 Web 標準、Chrome 會警告、已從標準移除趨勢。**僅限極簡單同步邏輯或舊專案緊急修復。**

方案二:回調函數模式 (Callback) - 傳統做法

function fetchData(callback) {
    $.ajax({
        url: '/api/data',
        success: function(data) {
            callback(data); // 將資料傳給回調
        }
    });
}

// 使用
fetchData(function(data) {
    console.log('拿到資料:', data);
    // 後續邏輯寫在這裡
    renderUI(data);
});

缺點:多層巢狀導致「回調地獄」、錯誤處理分散、難以串聯多個非同步操作。

方案三:Promise / async-await (現代標準,強力推薦)

// 封裝為 Promise
function fetchData() {
    return $.ajax({ url: '/api/data' }); // jQuery jqXHR 本身就是 Promise-like
}

// 使用 async/await (需在 async 函數中)
async function handleData() {
    try {
        var data = await fetchData();
        console.log('拿到資料:', data);
        renderUI(data);
    } catch (err) {
        console.error('請求失敗:', err);
        showError('載入失敗');
    }
}

// 並行請求
async function loadMultiple() {
    var [users, posts] = await Promise.all([
        $.ajax('/api/users'),
        $.ajax('/api/posts')
    ]);
    // 兩個都完成才執行這裡
}

jQuery 具體遷移步驟

  1. 將 $.ajax 封裝為回傳 Promise 的函數。
  2. 將原本在 success 內的邏輯移至 await 之後。
  3. 錯誤處理統一用 try/catch。
  4. 移除所有 async: false。

進階:全域狀態管理 (Vuex/Redux/Pinia/Context)

若需跨元件共享 AJAX 資料,**不要用全域變數**,改用狀態管理:

// Vue 3 + Pinia 範例
// stores/user.js
export const useUserStore = defineStore('user', {
    state: () => ({ profile: null, loading: false }),
    actions: {
        async fetchProfile() {
            this.loading = true;
            try {
                this.profile = await $.ajax('/api/profile');
            } finally {
                this.loading = false;
            }
        }
    }
});

// 元件中
const store = useUserStore();
await store.fetchProfile();
console.log(store.profile); // 響應式、跨元件共享

總結

  • 非同步本質:JS 不會等待 AJAX,後續代碼先執行。
  • 拒絕 async: false:阻塞主執行緒,違反現代最佳實踐。
  • 拥抱 Promise/async-await:線性寫法、統一錯誤處理、易於組合。
  • 狀態管理庫:替代全域變數,提供響應式、開發工具支援。

理解事件循環與非同步流程,是前端進階的必修課。

copyright © 萬盛學電腦網 all rights reserved