「'$.browser.msie' 為空或不是對象」是升級 jQuery 之後最常見的報錯之一。它看起來像是語法錯誤,其實是一個 API 被正式除役後留下的足跡。
$.browser.msie 屬於 $.browser 這組瀏覽器判斷屬性。這組屬性自 jQuery 1.3 起就不被建議使用,並在 1.9 版本中完全移除。因此當你的頁面從 1.9 之前升到 1.9 之後,任何讀取 $.browser.msie 的程式碼都會拿到 undefined,接著在後續的條件判斷或屬性存取時抛出錯誤。
換句話說,問題不在 jQuery 壞了,而在這行判斷式背後的假設已經不成立:它假定「IE 一定會被辨識出來」,但新版 jQuery 不再提供這個資訊。
問「有沒有這個功能」永遠比問「是哪個瀏覽器」可靠。例如判斷是否為舊版 IE,可以看 documentMode:
var isOldIE = document.documentMode ? document.documentMode : 8;
if (isOldIE === 8) { /* 針對 IE8 的處理 */ }
若目的是決定要不要套用某段相容樣式,更乾淨的做法是用註解條件語法在 head 中掛上對應 class,再由 CSS 接手。
確實需要版本號時,從 navigator.userAgent 擷取即可,並把判斷結果存成變數重用,別在每個事件處理器裡重算一次。
專案裡還有很多老插件依賴 $.browser 時,可以先載入 jQuery Migrate 把舊介面補回來,讓頁面先正常運作,再依 console 的告警逐處替換。請把它當成搬遷階段的扶手,而不是永久方案。
既然已經在改,不妨一次把同期的用法整理乾淨:
$.browser → 特性偵測或 documentMode.live()、.die() → .on()、.off().toggle(fn, fn) → 自行維護狀態旗標.size() → .length.andSelf() → .addBack()更多背景與替代寫法可參考:jQuery 版本差異說明、$.browser 的替代方案。
結語很簡單:這個錯誤是升級訊號,不是災情。把瀏覽器判斷換成功能判斷,你的程式碼會更耐得住下一個版本。