以下以「余額支付」為例,說明如何用 FireBug 調試 jQuery 的 Ajax 呼叫流程。
<input type="submit" name="pay_btn" id="pay_btn" value="確認支付" />
<script type="text/javascript">
$(function(){
$("#pay_btn").bind("click", ABC.balancePay);
});
</script>
使用 $.post 並搭配 Promise 風格的 done:
var ABC = {
balancePay: function(event){
event.preventDefault();
var tthis = $(event.currentTarget);
var form = tthis.parents('form');
var url = form.attr('action');
var data = 'code=15';
var jqXhr = $.post(url, data, undefined, 'jsonp');
jqXhr.done(function(datas){
$("#msg").text('結果:' + data);
});
}
}
也可直接指定回呼函數:
var jqXhr = $.post(url, data, function(data){
$("#msg").text('結果:' + data);
}, 'jsonp');
或使用 $.ajax 並加上 error 處理:
var jqXhr = $.ajax({
type: 'post',
url: url,
data: {code: '15'},
dataType: 'jsonp',
success: function(data){ alert('good'); },
error: function(XMLHttpRequest, textStatus, errorThrown) {
// 此 error 函數在調試時非常有用
alert(XMLHttpRequest.status);
alert(XMLHttpRequest.readyState);
alert(textStatus); // parser error;
}
});
伺服器端需接收並回傳資料,特別注意回呼函數名稱的拼接以及編碼方式須與客戶端一致:
// 注意使用的編碼方式需要和客戶端請求保持一致
// echo $_POST['callback'] . '(' . json_encode($result) . ');';
exit(0);
Firefox 的 FireBug 外掛功能強大;此外 Chrome、Safari、IE8 皆內建開發者工具(Chrome/Firefox 可用 Ctrl+Shift+C 快速開啟)。借助這些工具,可以詳細檢視 Ajax 的執行過程。
1. 查看回呼:Ajax 以非同步方式執行,若伺服器端出錯,頁面不會顯示任何訊息,需透過工具查看。特別提醒:若在伺服器端用 echo 等輸出除錯變數,會導致回呼函數名稱被更動而造成解析失敗。例如輸出 333,最終回呼變成 333ajaxcallback(1);,客戶端找不到該函數便無法解析。
2. 使用 error 函數:error 事件的第一個參數 XMLHttpRequest 含有有用資訊:
readyState:0 未初始化、1 載入中、2 載入完成、3 交互中(解析回應)、4 完成。status:HTTP 狀態碼,如 404 表示找不到頁面。textStatus:可能為 "timeout"、"error"、"notmodified"、"parsererror"。
3. 使用 console.log:相較於頻繁彈出的 alert(),console.log 會把結果輸出到 FireBug 的控制台面板,是更友善的除錯方式。
若 error 回報 parsererror,通常是伺服器端編碼問題,可在伺服器處理函式的開頭加上對應的 header,例如 header('Content-type: text/html; charset=utf-8');。最常見的則是 JSON 格式不正確:
echo "{'re':'success'}"; // jQuery 無法解析
echo "{\"re\":\"success\"}"; // 正確,不會出錯
請勿輸出怪異的 JSON 字串(如 {abc:1} 或 {'abc':1}),否則 jQuery 1.4+ 不會執行 success 回呼。正確寫法應為 {"abc":1},並將 {'success':true} 改為 {"success":true}。