這是一個關於「程式碼明明沒錯,卻在別人的機器上跑不動」的真實案例。問題最後被追到兩個地方:瀏覽器版本差異,以及 jQuery 版本差異。這類 bug 最耗時間,因為程式碼邏輯完全正確,你會一直往錯誤的方向找。
先說這個專案。它用 JavaScript 實作了一個拖拽排序功能:
一開始進入專案時完全沒頭緒,請教師兄也說不好做。正當打算改用傳統方式時,想到時間還算充裕,於是回到拖拽方案上繼續嘗試,最後終於做出來了。
與此同時,另一個夥伴用傳統方案(點擊上下按鈕對調順序)寫了一份 Demo:
在她的機器上演示時相當令人印象深刻——滑鼠滑過,程式碼(長長的 jQuery 鏈式呼叫)一頁頁翻過,寫法非常俐落。當時就想,等專案結束一定要好好研究這份實作。
兩個月後終於有空,由於對 jQuery 還不熟,看程式碼看得很吃力,勉強讀懂之後一跑,卻出現了問題:移動時一直彈出「無選擇項」。
相關程式碼如下:
for(var j = 0; j < div_count; j++){
if( ($("#eva_div_all").children().eq(j).children().children().eq(0).attr('checked')) == 'checked' ){
var valid_checked = $("#eva_div_all").children().eq(j).children().children().eq(0).attr('id');
if(valid_checked == checked_name){ alert(alert_des); return; }
/* 對調 */
var temp = $("#eva_div_all").children().eq(j).attr('id');
var temp_html = $("#" + temp).html();
var before_temp = $("#eva_div_all").children().eq(j + num).attr('id');
var before_temp_html = $("#" + before_temp).html();
$("#" + temp).html('');
$("#" + before_temp).html('');
$("#" + temp).html(before_temp_html);
$("#" + before_temp).html(temp_html);
checked = 'true';
new_order();
}
}
if(checked == 'false'){
alert('無選擇項!!');
}
程式邏輯是:遍歷所有項目,找出被勾選(checked)的那一個,再把它和目標位置的項目內容互換。找不到任何勾選項就警示。
症狀像是「走進眼中的飛蟲」,怎麼揉都揉不出來,一天就這麼過去了。
無奈之下只好請原作者來看。她調了很久還是不行,於是把她本地的程式碼拿出來逐行比對——毫無差異,而且她本地執行完全正常。既然程式碼一樣、結果不同,那問題必然在環境。於是雙方達成共識:瀏覽器問題。
$("#eva_div_all").children().eq(j).children().children().eq(0).attr('checked') == 'checked'
瀏覽器對 checked 屬性的支援不一致。 她用的是 Firefox 23,作者用的是 16.0.1。找到症結後,此事暫告一段落。
一週後,用同樣的瀏覽器訪問伺服器上的資源,問題又不存在了。這說明瀏覽器版本並不是根本原因。
繼續追下去,靈光一閃:把原本引入的 jquery.js 換成 jquery-1.7.2.min.js,問題終於再次被解決。
關鍵在於 jQuery 1.6 對「屬性」與「財產」做了明確區分,這是 jQuery 發展史上最重要的破性變更之一:
.attr('checked') 回傳布林值 true / false。.attr('checked') 改為回傳字串 "checked" 或 undefined(反映 HTML 屬性的實際存在與否),而 DOM 財產狀態改由新/methods .prop('checked') 負責,回傳布林值。.attr('checked') 又改回對布林狀態較友善的行為,但官方明確建議改用 .prop()。這段程式碼寫的是 .attr('checked') == 'checked'——只有在特定 jQuery 版本區間內才會成立。換成 1.7.2 之所以能解決,就是因為該版本的行為剛好與這段判斷相符。至於不同瀏覽器表現有異,則是疊加了各版本對 DOM 屬性 reflection 的細節差異。
無論 jQuery 版本為何,勾選狀態都應該用 .prop():
// 讀取勾選狀態(回傳真正的布林值)
var isChecked = $("#eva_div_all").children().eq(j).find("input").eq(0).prop("checked");
if (isChecked) {
// ...
}
// 設定勾選狀態
$("input:radio").prop("checked", true);
// 原生 DOM 也可以,最不受版本影響
document.querySelectorAll("#eva_div_all input")[j].checked;
這個案例的三個教訓:
checked、selected、disabled、value 這類會隨使用者互動變化的,都屬於 DOM 財產,應使用 .prop();id、class、data-*、href 這類寫在標籤上的才是屬性,用 .attr()。jquery.js 換成 jquery-1.7.2.min.js 就解決,正是這個道理。最後,作者也保留了一份幽默感:不知道還會不會再被推翻。答案是很有可能——只要專案裡還留著任何依賴特定版本行為的寫法,類似的問題就會一再出現。