把 jQuery 從 1.9 之前升到 1.9 之後,網頁突然跳出「'browser.opera' 為空或不是對象」的錯誤訊息,這是許多舊專案都碰過的一關。原因並不在你的程式碼寫壞了,而是你依賴的 API 被移除了。
$.browser 這組屬性從 jQuery 1.3 起就被標記為不建議使用,並在 1.9 版本正式移除。它原本用來判斷瀏覽器名稱與版本,包含 $.browser.msie、$.browser.opera、$.browser.mozilla、$.browser.safari 等。一旦頁面或插件裡還有 if ($.browser.opera) 這類寫法,在新版 jQuery 下讀到的就是 undefined,於是瀏覽器丟出「為空或不是對象」。
常見的觸發情境有三種:自行撰寫的舊程式碼、老版本的前端插件,以及曾經熱門的 Opera 專屬分支判斷(Opera 後來放棄 Presto 引擎,這類判斷早已失去意義)。
jQuery 官方建議的方向是判斷「功能是否存在」,而不是判斷「是哪個瀏覽器」。例如原本寫:
if ($.browser.msie) { /* 走 IE 分支 */ }
可以改為檢查你要用的那項能力:
if (document.addEventListener) { /* 支援標準事件模型 */ }
if (window.XMLHttpRequest) { /* 可進行 AJAX 請求 */ }
if ('opacity' in document.documentElement.style) { /* 支援 opacity */ }
若業務邏輯實在繞不開版本判斷,就自行取用 navigator.userAgent 做比對,並把結果快取成一個全域變數,避免重複計算。
手上還有一堆舊插件無暇全面改造時,可以引入官方提供的 jQuery Migrate。它會把 $.browser 等舊介面重新補回來,並在 console 中提示哪些用法已被淘汰,方便你逐項替換。這是過渡手段,不適合當長期方案。
$.browser,把命中處一次處理乾淨。document.documentMode 判斷。延伸閱讀:jQuery 版本變更說明、$.browser 移除後的替代寫法。
一句話總結:這個錯誤不是你的程式出了 BUG,而是提醒你「判斷瀏覽器」的時代結束了,該換成「判斷功能」。