| 特性 | 非同步 async: true (預設) |
同步 async: false |
|---|---|---|
| UI 回應 | 不阻塞,使用者可繼續操作 | **凍結瀏覽器**,頁面無反應直到請求完成 |
| 程式流程 | 回呼/ Promise 續行 | 阻塞當前執行緒,`$.ajax` 返回 jqXHR,可直接取 `responseText` |
| 適用場景 | 幾乎所有生產環境請求 | 極少數:頁面卸載前儲存草稿、依序必須完成的初始化鏈 (建議改用 Promise 鏈) |
| 瀏覽器支援 | 全支援 | **主執行緒阻塞已被標準棄用**,Chrome 80+ 主執行緒同步 XHR 會拋警告,未來可能移除 |
$('#btn_saveFWSB').click(function() {
var obj = checkData(arr);
if (obj.flag === true) {
hideAddDiv();
$.ajax({
type: 'POST',
url: '/vts/doInsertFWZT.do',
async: false, // ⚠️ 同步模式:阻塞 UI
data: {
ip: obj.ip,
port: obj.port,
lx: obj.lx,
fwq: obj.fwq,
connIP: obj.connIp,
direct: obj.direct
},
success: function(data) {
if (data.success === false) {
alert(data.msg);
}
}
});
} else {
alert(obj.msg);
}
});
// 1. 將檢查邏輯 Promise 化
function validateAndGetData(arr) {
return new Promise((resolve, reject) => {
const obj = checkData(arr);
if (obj.flag) resolve(obj);
else reject(new Error(obj.msg || '驗證失敗'));
});
}
// 2. 送出請求 (預設非同步)
async function saveData(obj) {
try {
const response = await fetch('/vts/doInsertFWZT.do', {
method: 'POST',
headers: {'Content-Type': 'application/x-www-form-urlencoded'},
body: new URLSearchParams({
ip: obj.ip,
port: obj.port,
lx: obj.lx,
fwq: obj.fwq,
connIP: obj.connIp,
direct: obj.direct
})
});
const data = await response.json();
if (!data.success) throw new Error(data.msg);
return data;
} catch (err) {
// 網路錯誤、HTTP 錯誤、業務失敗統一捕捉
throw err;
}
}
// 3. 整合呼叫
$('#btn_saveFWSB').on('click', async function() {
const $btn = $(this).prop('disabled', true);
try {
const obj = await validateAndGetData(arr);
hideAddDiv();
const result = await saveData(obj);
// 成功後續處理...
console.log('儲存成功', result);
} catch (err) {
alert(err.message);
} finally {
$btn.prop('disabled', false);
}
});
$('#btn_saveFWSB').click(function() {
const obj = checkData(arr);
if (!obj.flag) {
alert(obj.msg);
return;
}
hideAddDiv();
$.ajax({
type: 'POST',
url: '/vts/doInsertFWZT.do',
data: { // jQuery 自動序列化為 application/x-www-form-urlencoded
ip: obj.ip,
port: obj.port,
lx: obj.lx,
fwq: obj.fwq,
connIP: obj.connIp,
direct: obj.direct
},
dataType: 'json' // 自動解析 JSON 回呼參數
})
.done(function(data) {
if (data.success === false) alert(data.msg);
else { /* 成功處理 */ }
})
.fail(function(jqXHR, textStatus, errorThrown) {
alert('請求失敗:' + textStatus + ' ' + errorThrown);
})
.always(function() {
// 完成時共同邏輯 (如關閉 loading)
});
});
若有「步驟 B 必須等步驟 A 完成」的順序依賴,**請使用 Promise 鏈或 async/await 串接非同步呼叫**,而非阻塞主執行緒。這能保持 UI 回應、支援並發控制 (如同時限制 3 個請求)、利於除錯與測試。