ajax 的名字裡就有「異步」(Asynchronous JavaScript And XML),但 jQuery 確實提供了 async: false 讓它變成同步。這個選項在實戰中經常被誤用,本文把常見的幾個困惑逐一說清。
這是最典型的錯誤寫法:
// 錯誤示範
$.ajax({
url: 'your url',
data: { name: value },
cache: false,
async: true,
type: "POST",
dataType: 'json',
success: function (result) {
return result; // 這個 return 只會結束回調函數自己
}
});
success 是一個獨立的回調函數,它的返回值丟給了 jQuery 內部,外層函數拿不到。正確做法是用外部變量承接:
var ret = null;
$.ajax({
url: 'your url',
data: { name: value },
cache: false,
async: true,
type: "POST",
dataType: 'json',
success: function (result) {
ret = result;
}
});
// 注意:異步情況下這裡的 ret 仍是 null
return ret;
但這段代碼只在 async: false 時才真的能拿到值——異步請求尚未返回,下一行就已經執行了。這正是很多人誤以為「ajax 同步失敗」的根源。
async: "false" // 錯:加了引號就是字符串
非空字符串在布爾語境中為真,所以這行等同於 async: true。去掉引號,寫成布爾值 false 才是正確的。
從 jQuery 1.8 起,async: false 被標記為已棄用(deprecated),在部分環境(如 Chrome 主線程)會直接忽略並打印警告。原因是同步 ajax 會阻塞整個瀏覽器主線程:請求期間頁面無法渲染、無法響應點擊,用戶體驗極差,還會觸發瀏覽器的「頁面無響應」提示。
方案一:回調函數(推薦)。把依賴請求結果的邏輯寫進 success 或 then 中,而不是試圖在 ajax 之後同步取用。
$.ajax({ url: 'your url', data: { name: value } })
.done(function (result) {
// 在這裡處理後續邏輯
})
.fail(function (xhr, status, error) {
console.error(error);
});
方案二:async/await。基於 Promise 的語法讓異步代碼讀起來像同步:
async function loadData() {
try {
var result = await $.ajax({ url: 'your url', data: { name: value } });
// 這裡可以像同步代碼一樣繼續寫
} catch (e) {
console.error(e);
}
}
方案三:借 jQuery 1.x 的 Deferred。老項目中可用 $.when($.ajax(...)).then(...) 表達依賴關係。
極少數場景(例如 unload 前必須把數據發出去)確實需要阻塞,此時現代做法是 navigator.sendBeacon(url, data),它能在頁面卸載時異步可靠地發送數據,不阻塞渲染,也不受 ajax 同步限制。
總結一句:不要跟框架的異步設計對抗。遇到「拿不到返回值」的問題,答案幾乎總是把後續邏輯搬進回調,而不是把 async 改成 false。