把專案中的 jQuery 升到新版之後,部分頁面開始拋出這樣的錯誤:
Cannot read property 'msie' of undefined
到 jQuery 官方網站查過才確認原因:$.browser 這組 API 自 jQuery 1.9 起正式移除,程式碼中只要用到它就會出現這個錯誤。
順著這條線索讀下去會發現,jQuery 1.9 把先前標記為 deprecated 的 API 一次全部刪除,不再維持向後相容。這代表升級之後,得自行把舊寫法改寫成新 API,或自己補回那些被拿掉的功能。
所幸官方也意識到這個破壞性變更造成的困擾,另外釋出了 jQuery Migrate 外掛,用來自動補回被移除的 API。引入之後,既有程式碼不必更動即可搭配新版 jQuery 運行。
做法一:引入 jQuery Migrate
下載外掛後,在 jQuery 之後補上一行引用即可:
<script src="https://code.jquery.com/jquery-1.10.2.js"></script>
<script src="https://code.jquery.com/jquery-migrate-1.2.1.js"></script>
這個方式最省事,代價是多載入一個 JS 檔。
做法二:自行補一個精簡的 \$.browser
若不想增加額外檔案,可以自己實作所需的部分。以下程式碼的位置需放在 jQuery 之後、用到 $.browser 的程式碼之前:
jQuery.browser={};(function(){jQuery.browser.msie=false; jQuery.browser.version=0;if(navigator.userAgent.match(/MSIE ([0-9]+)./)){ jQuery.browser.msie=true;jQuery.browser.version=RegExp.$1;}})();
它只還原 msie 與 version 兩個欄位,體積極小。
不過更根本的建議是:既然已在升級,不如趁機把 $.browser 的判斷改成特性偵測。例如原本用 if($.browser.msie) 走的相容分支,多半可以換成檢查實際要用到的那個 API 是否存在——判斷「能不能用」向來比判斷「是什麼瀏覽器」可靠。