做頁面時常需要從網址列取出參數,例如 page.html?url=xxx&img=yyy。網路上找得到的寫法很多,品質參差不齊,特別是跨瀏覽器的相容性與執行速度往往沒人交代。這裡提供一個不依賴任何函式庫、也不依賴正則的版本。
<script language="javascript">
function request(paras) {
var url = location.href;
var paraString = url.substring(url.indexOf("?") + 1, url.length).split("&");
var paraObj = {};
for (var i = 0; i < paraString.length; i++) {
var j = paraString[i];
paraObj[j.substring(0, j.indexOf("=")).toLowerCase()]
= j.substring(j.indexOf("=") + 1, j.length);
}
var returnValue = paraObj[paras.toLowerCase()];
if (typeof (returnValue) == "undefined") {
return "";
} else {
return returnValue;
}
}
var theurl = request('url');
var theimg = request('img');
document.writeln("<a href='" + theurl + "' target=_blank>"
+ "<img src=" + theimg + " width=750 height=450 border=0></a>");
</script>
整個函式做的事可以拆成四步。先取 location.href 並用 indexOf("?") + 1 切出問號後面的查詢字串;再用 split("&") 把它拆成 ["url=xxx", "img=yyy"] 這樣的陣列;接著遍歷每一項,用第一個 = 把鍵與值分開,組進一個物件;最後用 toLowerCase() 做大小寫不敏感的對照,取出目標值。
回傳前那個 typeof == "undefined" 的判斷是必要的:參數不存在的時候回傳空字串,比回傳 undefined 好,因為後者接在字串後面會顯示出「undefined」這幾個字。
沒有解碼。參數值若是中文或被編碼過,拿到的就是 %E4%B8%AD%E6%96%87 這種亂碼。要在回傳前補上解碼:
return decodeURIComponent(returnValue);
值裡含 = 會被截斷。split("=") 遇到 ?redirect=https://a.com?x=1 會切成三段。修正方式是只切第一刀:
var idx = j.indexOf("=");
var key = j.substring(0, idx);
var val = j.substring(idx + 1); // 後面全部當值,不管還有幾個 =
paraObj[key.toLowerCase()] = val;
沒有排除 hash 與空參數。網址若是 page.html?a=1#top,a 的值會變成 1#top。而網址是 page.html? 這種空字串的情況,split("&") 會得到一個空元素,迴圈裡對它做 indexOf("=") 會得到 -1,產生一個名稱為空、值為整串的怪屬性。這兩個都要過濾掉。
function getQueryParams() {
var search = location.search.charAt(0) === "?" ? location.search.substring(1) : "";
var result = {};
if (!search) { return result; }
var pairs = search.split("&");
for (var i = 0; i < pairs.length; i++) {
if (!pairs[i]) { continue; } // 跳過空項目
var idx = pairs[i].indexOf("=");
var key = idx < 0 ? pairs[i] : pairs[i].substring(0, idx);
var val = idx < 0 ? "" : pairs[i].substring(idx + 1);
result[decodeURIComponent(key)] = decodeURIComponent(val);
}
return result;
}
// 使用
var params = getQueryParams();
var url = params.url || '';
用 location.search 取代 location.href 再自己切,是個小改進——search 已經幫你去掉 hash 了,也明確只包含查詢字串部分。
如果不需要支援太舊的環境,請直接用原生的 URLSearchParams,它自動處理解碼、重複參數、空值與 hash:
var params = new URLSearchParams(location.search);
var url = params.get('url'); // 取單一值
var all = params.getAll('tag'); // 同名參數全部取出,回傳陣列
var has = params.has('token'); // 判斷是否存在
params.toString(); // 重新組回查詢字串
URLSearchParams 在現代瀏覽器與 Node.js 中都是標準支援。手寫解析的價值在於理解字串處理的細節,但正式專案沒必要自己維護這些邊界情況——你漏掉的每一個 case,都會變成某天的一張 bug 單。