DIV CSS 佈局教程網

jQuery 版本差異引發的 bug:attr('checked') 跨版本與跨瀏覽器陷阱
編輯:關於JavaScript     

這是一個關於「程式碼明明沒錯,卻在別人的機器上跑不動」的真實案例。問題最後被追到兩個地方:瀏覽器版本差異,以及 jQuery 版本差異。這類 bug 最耗時間,因為程式碼邏輯完全正確,你會一直往錯誤的方向找。

作品本身:JS 拖拽排序

先說這個專案。它用 JavaScript 實作了一個拖拽排序功能:

一開始進入專案時完全沒頭緒,請教師兄也說不好做。正當打算改用傳統方式時,想到時間還算充裕,於是回到拖拽方案上繼續嘗試,最後終於做出來了。

與此同時,另一個夥伴用傳統方案(點擊上下按鈕對調順序)寫了一份 Demo:

 

在她的機器上演示時相當令人印象深刻——滑鼠滑過,程式碼(長長的 jQuery 鏈式呼叫)一頁頁翻過,寫法非常俐落。當時就想,等專案結束一定要好好研究這份實作。

bug 出現:一直提示「無選擇項」

兩個月後終於有空,由於對 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 版本

一週後,用同樣的瀏覽器訪問伺服器上的資源,問題又不存在了。這說明瀏覽器版本並不是根本原因。

繼續追下去,靈光一閃:把原本引入的 jquery.js 換成 jquery-1.7.2.min.js,問題終於再次被解決。

這裡到底發生了什麼事

關鍵在於 jQuery 1.6 對「屬性」與「財產」做了明確區分,這是 jQuery 發展史上最重要的破性變更之一:

  • 1.6 之前:.attr('checked') 回傳布林值 true / false。
  • 1.6 引入:.attr('checked') 改為回傳字串 "checked" 或 undefined(反映 HTML 屬性的實際存在與否),而 DOM 財產狀態改由新/methods .prop('checked') 負責,回傳布林值。
  • 1.6.1 之後:為了緩解相容性問題,.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;

這個案例的三個教訓:

  1. 「屬性」與「財產」要分清。 checked、selected、disabled、value 這類會隨使用者互動變化的,都屬於 DOM 財產,應使用 .prop();id、class、data-*、href 這類寫在標籤上的才是屬性,用 .attr()。
  2. 依賴版本行為的程式碼遲早會壞。 一旦你的判斷式必須依賴「某個特定版本才這樣運作」,那它就是有問題的。查官方文件、用有明確語意承諾的 API,才是長久之計。
  3. 「別人機器能跑」不等於沒問題。 遇到這種情況,先比對的不只是程式碼,還有依賴函式庫的版本。把 jquery.js 換成 jquery-1.7.2.min.js 就解決,正是這個道理。

最後,作者也保留了一份幽默感:不知道還會不會再被推翻。答案是很有可能——只要專案裡還留著任何依賴特定版本行為的寫法,類似的問題就會一再出現。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved