純前端處理時常有一個場景:要把目前頁面的某個參數透傳給下一頁。做法就是從 window.location.href 把查詢字串拆出來。與其每次重寫一次解析邏輯,不如把它掛到 jQuery 上,變成 $.urlGet() 這樣全域可用的工具。
整個流程只有三步:用 ? 把網址切成「主體」與「查詢字串」兩半,再用 & 把查詢字串切成一組 key=value,最後用 = 把每一組再切成鍵與值,塞進一個物件裡回傳。
/**
* jQuery url get parameters function [取得 URL 的 GET 參數值]
* @character_set UTF-8
* @author Jerry.li (lijian@dzs.mobi)
* @version 1.2012.12.11.1400
*
* 用法:
* var GET = $.urlGet(); // 取得 URL 的所有 Get 參數
* var id = GET['id']; // 取出 id 的值
*/
;(function ($) {
$.extend({
/**
* url get parameters
* @public
* @return array()
*/
urlGet: function () {
var aQuery = window.location.href.split("?"); // 取得 Get 參數
var aGET = new Array();
if (aQuery.length > 1) {
var aBuf = aQuery[1].split("&");
for (var i = 0, iLoop = aBuf.length; i < iLoop; i++) {
var aTmp = aBuf[i].split("="); // 分離 key 與 Value
aGET[aTmp[0]] = aTmp[1];
}
}
return aGET;
}
});
})(jQuery);
開頭那個 ; 不是多餘的。前面若有其他函式庫或壓縮過的腳本少了分號結尾,直接寫 (function($){...}) 會被解析成呼叫前一個運算式而炸掉,加個分號隔開是最保險的習慣。
整個程式包在 IIFE 裡並把 jQuery 傳進來當作 $,這樣即使頁面其他函式庫佔用了 $,這段程式裡的 $ 依然安全指向 jQuery。
if (aQuery.length > 1) 這個判斷很重要:網址沒帶參數時 split("?") 只會得到一個元素,此時直接回傳空陣列,避免後續 aQuery[1] 是 undefined 而報錯。
沒有做 URL 解碼。參數值如果被編碼過(例如中文變成 %E4%B8%AD%E6%96%87),拿到的就是編碼後的字串。應該補上 decodeURIComponent:
aGET[aTmp[0]] = decodeURIComponent(aTmp[1] || '');
值裡含 = 會被截斷。split("=") 遇到 ?url=https://x.com?a=1 這種巢狀參數時會切好幾段。比較穩健的寫法是限制切一刀:
var idx = aBuf[i].indexOf("=");
var key = aBuf[i].substring(0, idx);
var val = aBuf[i].substring(idx + 1);
不要忘了 hash。如果是 page.html?a=1#section,最後一段的值會帶著 #section,需要先把 location.hash 去掉再解析。
今天的瀏覽器都支援 URLSearchParams,同樣的需求只要一行:
var id = new URLSearchParams(location.search).get('id');
它自動處理解碼、重複參數與空值,也不必依賴 jQuery。封裝成 jQuery 擴充的寫法在當時很優雅,但如果是新專案,直接用原生 API 會更省事也更可靠。