表單提交前用 Ajax 檢查名稱是否重複,於是自然地在 success 回調裡寫了 return false,想阻止提交。結果表單照樣提交,服務端還收到了一條重複數據。
function onSubmit() {
if ($('#name').val().length < 2) {
alert("名稱請不少於兩個漢字");
return false;
}
var t = new Date().getTime();
$.ajax({
type: "POST",
url: "/users/checkrepeat/",
data: "name=" + $('#name').val() + "&time=" + t,
success: function (res) {
if (res == 'exists') {
alert("名稱已存在,請修改.");
return false; // 這裡的 return 攔不住表單
}
}
});
}
第一,return 的歸屬錯了。success 是一個匿名回調函數,它裡面的 return false 只是結束這個回調自己的執行,返回值交給的是 jQuery 的內部調用鏈,跟外層的 onSubmit() 沒有任何關係。能阻止表單提交的,只有 onSubmit() 這個函數自己的返回值。
第二,也是更根本的:異步的時序不對。Ajax 的 async 默認為 true,也就是異步。請求發出去之後,瀏覽器不會原地等,而是立刻繼續執行 $.ajax() 之後的代碼。onSubmit() 在服務端響應回來之前就跑完了,此時函數返回 undefined——既不等於 false,表單自然照常提交。等 success 被回調時,表單可能已經離開了當前頁面。
一句話總結:異步函數的返回值無法傳給調用者,因為調用者在異步完成之前就已經拿到了返回值。
最直接的修法是把 async 設為 false,並用一個外部變量承載結果:
function onSubmit() {
if ($('#name').val().length < 2) {
alert("名稱請不少於兩個漢字");
return false;
}
var flag = true;
var t = new Date().getTime();
$.ajax({
type: "POST",
async: false, // 改為同步,後續代碼會等響應
cache: false,
url: "/users/checkrepeat/",
data: "name=" + $('#name').val() + "&time=" + t,
success: function (res) {
if (res == 'exists') {
alert("名稱已存在,請修改.");
flag = false; // 只改狀態,不在這裡 return
}
}
});
if (!flag) {
return false; // 由 onSubmit 自己決定是否阻止
}
}
兩個要點:success 裡只負責改 flag,return false 交給外層函數;async: false 保證執行到 if (!flag) 時響應已經回來。
同步 Ajax 會阻塞整個浏覽器 UI 線程,網絡一慢頁面就假死,現代實踐普遍不建議。更好的結構是把「提交」這個動作交給 Ajax 回調去觸發:
$("form").on("submit", function (e) {
e.preventDefault(); // 先阻止默認提交
var name = $('#name').val();
if (name.length < 2) {
alert("名稱請不少於兩個漢字");
return;
}
$.ajax({
type: "POST",
url: "/users/checkrepeat/",
data: { name: name, time: new Date().getTime() },
success: function (res) {
if (res === 'exists') {
alert("名稱已存在,請修改.");
} else {
$("form")[0].submit(); // 校驗通過,這裡才真正提交
}
},
error: function () {
alert("校驗失敗,請重試");
}
});
});
注意 $("form")[0].submit() 用的是原生 DOM 方法而非 jQuery 的——原生 submit() 不會再次觸發 submit 事件,因此不會造成無限遞歸。
把變量直接拼進 query string("name=" + value)在值含 &、= 或中文時會出問題,應改用對象形式 { name: name } 讓 jQuery 自動序列化並編碼。示例裡加時間戳是為了防 IE 對 GET 請求的緩存,如果改用 POST 或加 cache: false,就不需要這個技巧了。