當你需要在新專案中採用新版 jQuery,卻又得沿用舊程式碼時,jQuery Migrate 就是那座橋樑。它能偵測哪些功能已被棄用或移除,並在可能的情況下把它們補回來。更多資訊可參考專案的 README。
· 支援 console.trace() 追蹤警告來源,更容易定位問題出自哪一行程式碼。
· 遇到無效的 JSON 時會回傳警告訊息。
· 啟動時提示「Logging is active」,讓你確認插件確實已載入。
· 基於安全考量,jQuery 1.9 收緊了字串的處理方式;新版 Migrate 可以恢復該行為,但仍建議改用 $.parseHTML() 處理 HTML 字串。
· 對 $("<button>", { type: "button" }) 這種寫法會顯示錯誤警告。
最後要留意的是:這個插件能讓 jQuery 恢復到 1.6.4 之後任一版本被移除的功能。
上月 jQuery 釋出 1.9 與 2.0,官方同時推出 Migrate Plugin 1.0.0,用來搭配 1.9/2.0 偵測已移除或即將移除的功能,讓舊有的 jQuery 程式碼得以繼續運作。但似乎很多使用者不清楚這個插件的用途,直接升級到 1.9 或 2.0 卻沒有載入 migrate plugin,於是官方收到大量回饋,內容都是「某些舊功能不能用了」。
半個月後,官方針對這些回報做了修正,並同樣透過 jQuery CDN 提供:
<script src="https://code.jquery.com/jquery-1.9.0.js"></script> <script src="https://code.jquery.com/jquery-migrate-1.1.0.js"></script>
壓縮版本:
<script src="https://code.jquery.com/jquery-1.9.0.min.js"></script> <script src="https://code.jquery.com/jquery-migrate-1.1.0.min.js"></script>
理想上,一次完美的 jQuery 升級是不需要 migrate plugin 的;團隊開發它是為了讓部分已被移除的功能還能正常使用。此次改版最主要的变化是新增並預設開啟 debug mode,讓開發者清楚知道哪些程式必須修正才能在 jQuery 1.9 以上正常運作。
1. 預設開啟 Trace:所有支援 console.trace() 的瀏覽器,migrate 預設會直接把呼叫源顯示在 console 中。線上網站若不希望暴露這些資訊,可以設定 jQuery.migrateTrace = false 關閉。
2. 「Logging is active」訊息:看到這行就代表網頁已正確載入 migrate plugin,單純作為確認之用。
3. 恢復 $.parseJSON() 的寬鬆行為:jQuery 1.9.0 之前,$.parseJSON() 接受空字串或 undefined 這類無效 JSON 值並回傳 null 而不拋錯;Migrate 1.1.0 恢復了這個行為,同時會顯示錯誤提示。
4. 恢復 $("<button>", { type: "button" }):這種寫法在 1.9 中不支援 IE6/7/8,Migrate 1.1.0 同樣恢復支援並顯示錯誤訊息。
5. 取得方式:可在 jQuery Plugin 網站或 GitHub 上找到 Migrate plugin。
實務建議:migrate plugin 適合當過渡期的安全網,但別把它當成永久方案。開著 debug mode 逐一清掉警告訊息,才是真正的升級完成。