jQuery AJAX 預設非同步 (async: true) 是導致「驗證邏輯未等待回應即繼續執行」的經典陷阱。本文以使用者註冊驗證為例,剖析非同步執行流程,對比三種解決方案:回呼嵌套、同步阻塞 (已棄用)、Promise/async-await 現代最佳實踐。
$('input[name="username"]').blur(function() {
// 1. 格式驗證
var pattern = /^[a-z]\w{4,11}$/i;
if (!pattern.test(this.value)) {
showError('格式錯誤');
return false;
}
// 2. AJAX 檢查用戶名是否存在 (非同步!)
$.post('register.php?act=checkUser', { username: this.value }, function(data) {
if (data.status === 'error') {
showError(data.info);
return false; // 只能跳出回呼,無法阻止外層流程
}
}, 'json');
// 3. 這行會**立即執行**,不等待 AJAX 回應!
alert('成功'); // 錯誤:尚未驗證用戶名唯一性就提示成功
});
主執行緒: 格式驗證 → 發起 AJAX 請求 → 函數返回 → alert('成功') → 結束
↑ |
| | (稍後)
└──────────────────────────────┘
非同步回呼: PHP 處理 → 回應 → 回呼執行 (顯示錯誤/成功)
$.post(url, data, function(response) {
if (response.ok) {
$.post(nextUrl, moreData, function(response2) {
if (response2.ok) {
$.post(thirdUrl, ...); // 層層嵌套,難以維護、錯誤處理分散
}
});
}
});
var ajaxCheckUser = false;
$.ajax({
url: 'register.php?act=checkUser',
type: 'POST',
data: { username: $(this).val() },
async: false, // 阻塞主執行緒!瀏覽器會彈出警告、頁面凍結
success: function(data) {
if (data.status === 'success') ajaxCheckUser = true;
}
});
if (ajaxCheckUser) alert('成功');
嚴重後果:凍結主執行緒 → 頁面無響應、動畫卡頓、事件無法處理、Chrome 直接標記為「已棄用並將移除」。**嚴禁生產環境使用。**
function checkUsername(username) {
return new Promise(function(resolve, reject) {
$.post('register.php?act=checkUser', { username: username }, function(data) {
if (data.status === 'success') resolve(data);
else reject(new Error(data.info));
}, 'json').fail(function(jqXHR, textStatus, errorThrown) {
reject(new Error('網路錯誤: ' + textStatus));
});
});
}
// 或使用 jQuery 3+ 內建 Promise 介面
function checkUsername(username) {
return $.post('register.php?act=checkUser', { username: username }, null, 'json')
.then(function(data) {
if (data.status === 'success') return data;
throw new Error(data.info);
});
}
$('input[name="username"]').blur(async function() {
var $input = $(this);
var pattern = /^[a-z]\w{4,11}$/i;
// 1. 格式驗證 (同步)
if (!pattern.test($input.val())) {
showError('5-12字元,字母開頭,僅限字母數字底線');
return;
}
try {
// 2. 非同步等待驗證結果
await checkUsername($input.val());
// 3. 只有這裡才會在驗證通過後執行
showSuccess('用戶名可用');
} catch (err) {
showError(err.message);
}
});
async function validateForm(formData) {
// 並行發起多個驗證請求
var [userResult, emailResult, phoneResult] = await Promise.all([
checkUsername(formData.username),
checkEmail(formData.email),
checkPhone(formData.phone)
]);
// 全部通過才繼續
return { user: userResult, email: emailResult, phone: phoneResult };
}
$.post 回傳 jqXHR,支援 .done()/.fail()/.always() 鏈式調用,可直接 .then() 轉 Promise。jqXHR 完整實現 Promise 介面,可直接 await $.post(...)。$.post(url, data, successCallback, dataType) — 成功回呼是第 3 參數,dataType 是第 4 參數。原始碼中將回呼誤放第 3 參數、dataType 誤放第 4 導致回呼未被識別。| 方案 | 優點 | 缺點 | 推薦度 |
|---|---|---|---|
| 回呼嵌套 | 無額外依賴 | 地獄嵌套、錯誤處理碎片化、難除錯 | ❌ |
| 同步 AJAX | 代碼看起來同步 | 阻塞主執行緒、瀏覽器警告、已棄用、違反 Web 原則 | ❌❌❌ |
| Promise + async/await | 線性閱讀、統一錯誤處理、易並行/超時控制、標準化 | 需 ES2017+ (現代瀏覽器/Node 全支援) | ✅✅✅ |
非同步是 JavaScript 基因,**擁抱 Promise/async-await** 而非對抗它,才能寫出可維護、高效能、符合現代標準的代碼。立即將專案中所有 async: false 替換為 Promise 化方案。