幾乎每個 jQuery 新手都會撞上這個問題:在 $.ajax() 的 success 回呼裡寫 return true,外層卻永遠收到 undefined。本文把成因與兩種解法講清楚。
function getReturnAjax(){
$.ajax({
type:"POST",
data:"username="+vusername.value,
success:function(msg){
if(msg=="ok"){
showtipex(vusername.id,"<img src='images/ok.gif'/><b><font color='#ffff00'>該用戶名可以使用</font></b>",false)
return true;
} else {
showtipex(vusername.id,"<img src='images/cancel.gif'/><b><font color='#ffff00'>該用戶名已被注冊</font></b>",false);
vusername.className="bigwrong";
return false;
}
}
}
但呼叫 getReturnAjax() 時,取到的永遠是 false。也就是說 return true 與 return false 根本沒起作用;在 Firefox 下用 Firebug 除錯也證實,程式根本不會執行到 return 那一行。
return 只能把值交還給「呼叫它的那個函式」。而 success 回呼並不是由 getReturnAjax() 直接呼叫的,它是等 HTTP 回應到來後,由 jQuery 內部代為觸發。等到那時,getReturnAjax() 早已執行完畢並回傳了 undefined。這不是 bug,而是異步執行的必然結果。
function getAjaxReturn(){
var bol=false;
$.ajax({
type:"POST",
data:"username="+vusername.value,
success:function(msg){
if(msg=="ok"){
showtipex(vusername.id,"<img src='images/ok.gif'/><b><font color='#ffff00'>該用戶名可以使用</font></b>",false)
bol=true;
} else {
showtipex(vusername.id,"<img src='images/cancel.gif'/><b><font color='#ffff00'>該用戶名已被注冊</font></b>",false);
vusername.className="bigwrong";
}
}
return bol;
}
結果仍然不起作用——理由完全相同:return bol 執行時,回應還沒回來,bol 還是初始的 false。
function getAjaxReturn() {
var bol=false;
$.ajax({
type:"POST",
async:false,
data:"username="+vusername.value,
success:function(msg){
if(msg=="ok"){
showtipex(vusername.id,"<img src='images/ok.gif'/><b><font color='#ffff00'>該用戶名可以使用</font></b>",false)
bol=true;
} else {
showtipex(vusername.id,"<img src='images/cancel.gif'/><b><font color='#ffff00'>該用戶名已被注冊</font></b>",false);
vusername.className="bigwrong";
}
}
return bol;
}
加上 async:false 之後就改為同步了。用同事的說法:這會等 ajax 有了返回值之後才執行下面的 JS。一語道破天機——難怪以前很多 ajax 呼叫裡的賦值都不起作用。這樣 ajax 給 bol 賦值完畢後,才會執行到 return,值就正確了。
但這不是好方案。同步請求會凍結整個瀏覽器 UI,網路一慢畫面就像當機,使用者連捲動都做不到。除了一次性的腳本初始化,實務上應該避免。
function getAjaxReturn(success_function, fail_function){
$.ajax({
type:"POST",
data:"username="+vusername.value,
success:function(msg){
if(msg=="ok"){
showtipex(vusername.id,"<img src='images/ok.gif'/><b><font color='#ffff00'>該用戶名可以使用</font></b>",false)
success_function(msg);
}
else {
showtipex(vusername.id,"<img src='images/cancel.gif'/><b><font color='#ffff00'>該用戶名已被注冊</font></b>",false);
vusername.className="bigwrong";
fail_function(msg);
}
}
});
}
function success_function(info) // do what you want to do
alert(info);
function fail_function(info) // do what you want to do
alert(info);
把「回應到來後要做的事」當作參數交進去,由 ajax 決定何時呼叫它,這才是順著異步模型走的正確思路。
在支援 Promise 的環境中,可以直接利用 $.ajax() 回傳的 jqXHR 物件(它具備 then/done/fail 方法):
function checkUser() {
return $.ajax({ type:"POST", data:"username="+vusername.value });
}
// 呼叫端
checkUser().done(function(msg){
if(msg == "ok"){ /* 處理成功 */ }
}).fail(function(){ /* 處理失敗 */ });
若使用 async/await,語意會更貼近同步寫法:
async function onSubmit(){
try {
var msg = await checkUser();
if(msg == "ok"){ /* ... */ }
} catch(e) { /* ... */ }
}
關鍵觀念只有一句:異步的結果不靠 return 傳遞,而靠回呼或 Promise 承接。