DIV CSS 佈局教程網

browser.opera 為空或不是對象:jQuery 升級後的經典錯誤
編輯:JQuery常見問題     

把 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 */ }

方案二:自己解析 userAgent

若業務邏輯實在繞不開版本判斷,就自行取用 navigator.userAgent 做比對,並把結果快取成一個全域變數,避免重複計算。

方案三:暫時引入 jQuery Migrate

手上還有一堆舊插件無暇全面改造時,可以引入官方提供的 jQuery Migrate。它會把 $.browser 等舊介面重新補回來,並在 console 中提示哪些用法已被淘汰,方便你逐項替換。這是過渡手段,不適合當長期方案。

避免問題再發生

  • 升級 jQuery 前先全域搜尋 $.browser,把命中處一次處理乾淨。
  • 第三方插件優先選擇仍在維護、且已支援新版 jQuery 的版本。
  • 需要針對舊版 IE 做相容時,改用註解條件或 document.documentMode 判斷。
  • 養成寫特性偵測的習慣,程式碼會比一堆瀏覽器分支清爽得多。

延伸閱讀:jQuery 版本變更說明、$.browser 移除後的替代寫法。

一句話總結:這個錯誤不是你的程式出了 BUG,而是提醒你「判斷瀏覽器」的時代結束了,該換成「判斷功能」。

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