在傳統的多頁式網站裡,分頁、搜尋條件、表單結果幾乎都靠網址上的查詢字符串(query string)傳遞。前端要在不重新整理頁面的情況下把這些值拿出來用,就得自己解析 location.search。本文示範一個把整串參數打包成物件的通用函式,並補充現代瀏覽器的簡便寫法。
整個流程可以拆成四個動作:先取出問號後面的內容,再用 & 切成一組組的「鍵值對」,接著用 = 分出名稱與值,最後對兩者都做一次 decodeURIComponent() 還原編碼。因為中文、空格、特殊符號在傳輸時都會被轉成百分號編碼,少了這一步就會拿到一堆看不懂的字串。
/* 解析查詢字符串,回傳包含所有參數的物件 */
function getQueryStringArgs() {
// 取得查詢字符串並去掉開頭的問號
var qs = (location.search.length > 0 ? location.search.substring(1) : '');
// 用來保存解析結果的物件
var args = {};
// 以 & 切分出每一項
var items = qs.length ? qs.split('&') : [],
item = null,
name = null,
value = null, // 明確宣告,避免變成全域變數
i = 0,
len = items.length;
// 逐項寫入 args
for (i = 0; i < len; i++) {
item = items[i].split('=');
name = decodeURIComponent(item[0]);
value = decodeURIComponent(item[1]);
if (name.length) {
args[name] = value;
}
}
return args;
}
假設目前網址是 https://example.com/page?id=7&name=小明,只要執行 var params = getQueryStringArgs();,就能用 params.id 拿到 7、用 params.name 拿到還原後的中文。若網址沒有任何參數,函式會回傳一個空物件,後續取值不會出錯。
如果不是非要支援老舊的 IE,直接用內建的 URLSearchParams 會乾淨很多:
var params = new URLSearchParams(location.search);
var id = params.get('id'); // "7"
var hasName = params.has('name'); // true
它天生就處理了編碼與重複參數的問題,程式碼量不到原本的十分之一。不過理解手寫解析的原理仍然有用,因為它同時說明了「編碼」與「切割」這兩個關鍵環節。