jQuery 1.9.0 大概是在 1 月 15 日發布的。消息一出,社群上就有人說這次升級會「死掉大批插件」——因為它移除了很多常用 API。糾結了好一陣,最後還是決定把站點的 jQuery 升到 1.9.1。
官方大概也知道這次改動幅度大,特別提供了文件與插件協助推進升級。這個插件把「偵測」與「相容」打包在一起:只要把 jQuery 升到 1.9.1,然後在其後引入 jquery-migrate,就能最省事地跑起來。插件會把現有程式碼中用到已移除 API 的地方,以警告形式印在 console 上,一目了然。
不得不說這是相當有溫度的做法,很多國內開源專案反而做不到這種細節。
但有時候你就是不想多載一支腳本。那就只能照 jQuery 提供的升級指南,把每個改動過的 API 逐一改掉。以下是我自己實際碰到的問題:
讀寫 checked、readonly、selected 這類「狀態屬性」時,請改用 prop:
$('checkbox').attr('checked', 'checked'); //不推薦
$('checkbox').prop('checked', true); //推薦
官方把 hover 拿掉了,建議改成:
$('body').on({ 'mouseenter': fn1, 'mouseleave': fn2 });
這裡指的是「傳入多個函數輪流切換」的那個 toggle,不是控制隱藏顯示的 toggle。它沒有直接替代,需要依自己的條件邏輯改寫。
已被完全移除。改用第三方偵測庫(推薦 Modernizr,除了瀏覽器還能偵測特性),或直接讀 navigator.userAgent。不想引入整個庫可以按需下載部分原始碼:https://modernizr.com/download/
把原始碼裡的 live 直接換成 on 即可。
否則會報錯。最怕的是字串前面不小心有空白,我的解法是先 $.trim() 處理一次。
$("#status").ajaxStart(function(){ $(this).text("Ajax started"); }); //舊
$(document).ajaxStart(function(){ $("#status").text("Ajax started"); }); //新
從 1.7.1 升到 1.9.1 時,還踩到兩個不在文件裡的變化:
data() 在節點不存在時的返回值:取一個不存在節點的 data 值,1.7 回傳 undefined,1.9.1 回傳 null。假設頁面上沒有 id 為 none 的節點:
$('#none').data('anyKey'); //1.9.1 回傳 null
所以不能只用 typeof $('#none').data('anyKey') == 'undefined' 來判斷。
$.parseJSON 對空字串的容忍度:若後端意外回傳一個空字串(正常情況下像 PHP 的 json_encode() 都會處理好,但總有意外),1.9.1 會直接拋錯:
$.parseJSON(''); //SyntaxError: JSON.parse: unexpected end of data
1.9.1 之前不會報錯,看來容錯得自己做。解法是送出前先擋掉空值,例如 $.parseJSON('{}');。