預設 async: true(非同步),程式碼**不等待** AJAX 完成直接往下執行。設定 async: false(同步)會**阻塞瀏覽器主執行緒**,直到請求完成才繼續執行後續代碼。
$.ajax({
url: "../handle/Ladder_Fee_Code.ashx?ajaxaction=Select_FangAn",
type: "post",
dataType: "json",
cache: false,
async: false, // 關鍵:同步阻塞
success: function(data) {
alert("1 - 請求完成");
// 處理 data
}
});
alert("2 - 這行會等待 AJAX 完成後才執行");
// async: true (預設,非同步)
console.log("開始");
$.ajax({ url: "/api", success: () => console.log("成功") });
console.log("結束");
// 輸出順序:開始 → 結束 → 成功
// async: false (同步,阻塞)
console.log("開始");
$.ajax({ url: "/api", async: false, success: () => console.log("成功") });
console.log("結束");
// 輸出順序:開始 → 成功 → 結束
// 封裝為 Promise
function fetchData(url, params) {
return $.ajax({ url, data: params, dataType: "json" });
}
// 使用 async/await - 程式碼看起來同步,實際非阻塞
async function handleData() {
console.log("開始");
try {
const data = await fetchData("../handle/Ladder_Fee_Code.ashx", {
ajaxaction: "Select_FangAn"
});
console.log("1 - 請求完成", data);
// 後續邏輯自然寫在這裡
await processData(data);
console.log("2 - 處理完成");
} catch (error) {
console.error("請求失敗:", error);
}
}
handleData();
$.ajax({ url: "/api/step1", dataType: "json" })
.then(function(data1) {
console.log("步驟 1 完成", data1);
return $.ajax({ url: "/api/step2", data: { id: data1.id }, dataType: "json" });
})
.then(function(data2) {
console.log("步驟 2 完成", data2);
return $.ajax({ url: "/api/step3", data: { id: data2.id }, dataType: "json" });
})
.then(function(data3) {
console.log("步驟 3 完成", data3);
})
.catch(function(error) {
console.error("任一步驟失敗:", error);
});
// 並行發起多個請求,全部完成後再執行
$.when(
$.ajax({ url: "/api/users", dataType: "json" }),
$.ajax({ url: "/api/roles", dataType: "json" }),
$.ajax({ url: "/api/permissions", dataType: "json" })
).done(function(usersRes, rolesRes, permsRes) {
// 每個參數都是 [data, textStatus, jqXHR]
var users = usersRes[0];
var roles = rolesRes[0];
var perms = permsRes[0];
console.log("三個請求全部完成", users, roles, perms);
initPage(users, roles, perms);
}).fail(function(jqXHR, textStatus) {
console.error("至少一個請求失敗");
});
function loadData(callback) {
$.ajax({
url: "../handle/Ladder_Fee_Code.ashx",
data: { ajaxaction: "Select_FangAn" },
dataType: "json",
success: function(data) {
callback(null, data);
},
error: function(xhr, status, error) {
callback(error);
}
});
}
// 使用
loadData(function(err, data) {
if (err) { console.error(err); return; }
console.log("資料載入完成", data);
// 後續處理...
});
| 原同步代碼模式 | 遷移策略 |
|---|---|
| 多個連續 AJAX 相依 | 改用 async/await 串聯 |
| 迴圈中同步請求 | 改用 Promise.all 並行,或 for...of + await 串行 |
| 同步取得資料後初始化 UI | 改用 Promise,成功回呼中初始化 |
| 表單驗證需遠端檢查 | 改用非同步驗證,提交時攔截並等待 Promise |
// ❌ 錯誤:同步迴圈阻塞
for (var i = 0; i < ids.length; i++) {
$.ajax({ url: "/api/item/" + ids[i], async: false, ... });
}
// ✅ 正確:串行 await
async function processItems(ids) {
for (const id of ids) {
const result = await $.ajax({ url: "/api/item/" + id, dataType: "json" });
console.log("處理完成:", id, result);
}
}
// ✅ 正確:並行 Promise.all (無順序相依)
async function processItemsParallel(ids) {
const promises = ids.map(id => $.ajax({ url: "/api/item/" + id, dataType: "json" }));
const results = await Promise.all(promises);
console.log("全部完成:", results);
}
async: false 雖能讓 AJAX 表現得像同步代碼,但會嚴重阻塞主執行緒、降低使用者體驗、違反現代 Web 標準。**新專案請一律使用 Promise + async/await** 或回呼函式模式處理非同步流程。既有專案遇到同步代碼應逐步重構遷移。