用 jQuery 寫 ajax 時,除了 success 與 error,其實還有一整排全域事件可以掛。搞不清楚誰先誰後,就容易在錯的時機做錯的事。以下是一次完整請求的觸發順序。
1. ajaxStart(全域事件)
2. beforeSend
3. ajaxSend(全域事件)
4. success
5. ajaxSuccess(全域事件)
6. error
7. ajaxError(全域事件)
8. complete
9. ajaxComplete(全域事件)
10. ajaxStop(全域事件)
可以把它分成三段來記:
請求前:ajaxStart → beforeSend → ajaxSend。要注意 ajaxStart 只在「第一個」ajax 請求發出時觸發一次,而 beforeSend 是每個請求各自觸發。
請求完成時:success 與 error 是互斥的兩條分支,只會走其中一條,緊接著對應的全域事件 ajaxSuccess 或 ajaxError。
收尾:complete → ajaxComplete。這裡有個關鍵點——complete 無論成功或失敗都會執行,所以它常被拿來做「不管結果如何都要做」的清理工作,例如關閉 loading 動畫。而 ajaxStop 是在「所有」ajax 請求都結束後才觸發,與 ajaxStart 成對,適合用來全域性地顯示或隱藏進度提示。
全域事件(ajaxStart / ajaxStop / ajaxComplete)通常綁在文件上,用來處理「整個頁面層級」的狀態,例如頁首的 loading 圖示;而 beforeSend、success、complete 則是每個請求各自的回呼,用來處理「這一次請求」的細節。
把兩者分清楚,就不會出現「頁面有多個併發請求,loading 圖示閃一下就消失」這類問題——那正是誤用單一請求事件去處理全域狀態的結果。