jQuery 在執行 Ajax 的過程中會觸發許多事件,可分為兩類:
局部事件(Local):透過 $.ajax 設定,若某個請求不希望觸發全域事件,可設 global:false。
全局事件(Global):類似 click 等事件,可綁定到每個 DOM 元素上。
依觸發順序整理如下:
ajaxStart(全局):開始新的 Ajax 請求,且此時沒有其他請求正在進行。
beforeSend(局部):請求開始時觸發,可在此設定 XHR 物件。
ajaxSend(全局):請求開始前觸發。
success(局部):請求成功時觸發(伺服器未回錯誤、資料也無誤)。
ajaxSuccess(全局):全域的請求成功。
error(局部):僅發生錯誤時觸發,無法同時執行 success 與 error。
ajaxError(全局):全域的發生錯誤時觸發。
complete(局部):不論成功或失敗,請求完成時都會觸發。
ajaxComplete(全局):全域的請求完成時觸發。
ajaxStop(全局):當沒有 Ajax 正在進行時觸發。
除了 ajaxStart 與 ajaxStop 之外,其他事件都有三個參數:event、XMLHttpRequest、ajaxOptions,其中第三個參數最有用,是當時呼叫該 ajax 的參數。ajaxError 還有第四個參數 thrownError,只有發生異常時才會傳遞。
2.1 HTML 程式碼
<div>
<input type="button" onclick="BtnSpareClick();" value="PartEvents" />
<input type="button" onclick="BtnGlobalClick();" value="GlobalEvents" />
</div>
<div id="Result">Result</div>
<div id="Process">Process</div>
2.2 局部事件(Local)示例
<script language="javascript" type="text/javascript">
$.ready(function BtnSpareClick() {
$.ajax({
type: "get",
url: "https://www.poluoluo.com/windy2008/rss",
data: {},
global: false,
beforeSend: function(){ $("#Process").text("Part請求開始前"); },
success: function(data){
$("item", data).each(function(i, domEle){ $("#Result").append("<div>" + $(domEle).children("title").text() + "</div>"); });
$("#Process").text("Part請求成功時");
},
complete: function(){ $("#Process").text("Part請求完成時"); },
error: function(){ $("#Process").text("Part請求錯誤時"); }
});
});
</script>
全局事件(Global)示例
<script language="javascript" type="text/javascript">
$.ready(function BtnGlobalClick() {
$.get("https://www.poluoluo.com/windy2008/rss", {}, function(data){
$("item", data).each(function(i, domEle){ $("#Result").append("<div>" + $(domEle).children("title").text() + "</div>"); });
});
$("#Process").ajaxStart(function(){ $(this).text("開始新的Ajax請求"); });
$("#Process").ajaxStop(function(){ $(this).text("當沒有Ajax正在進行中的時候"); });
$("#Process").ajaxSend(function(){ $(this).text("請求開始前"); });
$("#Process").ajaxSuccess(function(){ $(this).text("請求成功"); });
$("#Process").ajaxComplete(function(){ $(this).text("請求完成時"); });
$("#Process").ajaxError(function(){ $(this).text("請求錯誤時"); });
});
</script>
透過這兩個示例,可以清楚看到局部事件與全域事件在 Ajax 生命週期中的觸發時機與差異。