jQuery.query.js 是解析網址查詢字串的老牌小工具,但實際用起來會踩到兩個坑,而且都很難一眼看出來。這篇記錄現象與修改方式。
當參數值含有空格時,取出來的值會變成 +。原因在於外掛在序列化時套用了 application/x-www-form-urlencoded 的規則,把空格編碼為加號;但反序列化時並沒有把它還原。
解法是找到 jQuery.query.js 中的 toString 方法,把主動轉換的那一行註解掉:
toString: function() {
var i = 0, queryString = [], chunks = [], self = this;
var encode = function(str) {
str = str + "";
// if ($spaces) str = str.replace(/ /g, "+"); ← 註解掉這行
return encodeURIComponent(str);
};
拿掉之後,空格會由 encodeURIComponent 編碼為 %20,取回來時自然還原成真正的空格。
這個更棘手。當某個 key 存在但沒有值(例如 ?flag&other=1),用 get() 取出來的會是布林值 true,而不是空字串或 null。若程式裡寫成 if (params.name === '') 之類的判斷,就會全部落空。
在 get 方法中補一段型別檢查即可:
get: function (key) {
var target = this.GET(key);
if (typeof (target) == 'boolean') return ''; // ← 新增這一段
if (is(target, Object)) return jQuery.extend(true, {}, target);
else if (is(target, Array)) return target.slice(0);
return target;
},
這樣無值的參數就會穩定回傳空字串,後續的 if (!params.xxx) 判斷才能如預期運作。
作者自己也註明了「是否有其他副作用暫時未實驗出」。改動第三方檔案前,建議先確認兩件事:一是專案裡是否有其他地方依賴原本的加號行為(例如某些後端框架確實把 + 當空格解析);二是團隊是否有共用的維護分支,避免各改各的最後無法合併。
更根本的建議是:能不動原始檔就不動。可以繼承或覆寫外掛的方法,把修改集中在自己的檔案裡,升級時才不會手忙腳亂。若專案已改用現代工具鏈,也可以考慮直接以 URLSearchParams 取代這類老舊外掛,行為標準且無需維護。