在 JavaScript 裡解析 query string 一直是件瑣事:要處理 ?、要處理 &、還要做 URL 解碼。這個小插件把這件事收攏成一個 $.request 介面,寫法刻意模仿 C# 的 Request 物件,讀起來非常直覺。
$.request = (function () {
var apiMap = {}; // 以 query string 為 key 的快取
function request(queryStr) {
var api = {};
if (apiMap[queryStr]) { return apiMap[queryStr]; }
api.queryString = (function () {
var urlParams = {};
var e,
d = function (s) { return decodeURIComponent(s.replace(/\+/g, " ")); },
q = queryStr.substring(queryStr.indexOf('?') + 1),
r = /([^&=]+)=?([^&]*)/g;
while (e = r.exec(q)) {
urlParams[d(e[1])] = d(e[2]);
}
return urlParams;
})();
api.getUrl = function () { // 把參數重新拼回成完整網址
var url = queryStr.substring(0, queryStr.indexOf('?') + 1);
for (var p in api.queryString) {
url += p + '=' + api.queryString[p] + "&";
}
if (url.lastIndexOf('&') == url.length - 1) {
return url.substring(0, url.lastIndexOf('&'));
}
return url;
};
apiMap[queryStr] = api; // 寫入快取
return api;
}
$.extend(request, request(window.location.href)); // 預先綁定目前網址
return request;
})();
設計上有兩個細節值得注意。第一是 replace(/\+/g, " "):查詢字串裡的加號代表空格,不解掉就會讓字串內容多出莫名的 + 號。第二是 apiMap 快取,同一組 query string 第二次呼叫時直接回傳既有物件,省下重複解析的正則開銷。
因為最後那行 $.extend(request, request(window.location.href)),所以當前頁面的參數可以直接用點號或索引取值:
var id = $.request.queryString["id"]; var name = $.request.queryString.name;
這個插件真正的價值在於——它可以解析任何字串,不侷限於瀏覽器網址列。我們常在標籤上掛一些非標準屬性來當作設定旗標,例如:
<a id="demo" href="javascript:;" config="?title=hello&auto=true&">Demo</a>
要讀取時,把該屬性的值丟給 $.request() 就完成了:
var config = $.request($("#demo").attr("config")).queryString;
var title = config.title; // "hello"
var auto = config.auto; // "true"
這種做法的好處是:不必為了一兩個設定而替元素加上五六個自訂屬性,一個 config 字串就能承載任意數量的參數,後端輸出 HTML 時也更好控制。我自己大多數時候就是拿它來讀這類配置資訊。
要注意 queryString 取出的值一律是字串,"true" 不會自動變成布林 true,"3" 也不會變成數字 3。需要型別時記得自己轉換,例如 config.auto === "true" 或 parseInt(config.page, 10)。