從 URL 查詢字符串裡取參數是極常見的需求——分頁、篩選、分享連結、頁面間傳值都會用到。下面整理四種實現,從囉嗦到簡潔排列,最後一種是今天該用的。
<script>
// 獲取地址欄的參數數組
function getUrlParams() {
var search = window.location.search;
var tmparray = search.substr(1, search.length).split("&"); // 去掉 ? 後按 & 拆分
var paramsArray = new Array;
if (tmparray != null) {
for (var i = 0; i < tmparray.length; i++) {
var reg = /[=|^==]/;
var set1 = tmparray[i].replace(reg, '&');
var tmpStr2 = set1.split('&');
var array = new Array;
array[tmpStr2[0]] = tmpStr2[1];
paramsArray.push(array);
}
}
return paramsArray;
}
// 根據參數名取值
function getParamValue(name) {
var paramsArray = getUrlParams();
if (paramsArray != null) {
for (var i = 0; i < paramsArray.length; i++) {
for (var j in paramsArray[i]) {
if (j == name) {
return paramsArray[i][j];
}
}
}
}
return null;
}
function test() {
alert("v=" + getParamValue("name"));
}
</script>
這段代碼思路是對的,但寫法相當繁瑣:先拆 &,再拆 =,把結果包成一個又一個單屬性對象塞進數組,取值時還要兩層循環遍歷。更麻煩的是它沒有做 URL 解碼——如果參數值裡有中文或經過 encodeURIComponent 編碼的內容,取出來會是 %E4%B8%AD%E6%96%87 這樣的亂碼。
另外那個正則 /[=|^==]/ 也有問題:方括號裡豎線是普通字符而非「或」,實際匹配的是「等號、豎線、或者等號」中的任意一個字符,與註釋裡說的意圖不符。
function GetUrlParam(paramName) {
var url = document.URL;
var oRegex = new RegExp('[?&]' + paramName + '=([^&]+)', 'i');
var oMatch = oRegex.exec(url);
if (oMatch && oMatch.length > 1) {
return oMatch[1];
} else {
return '';
}
}
這種寫法簡潔多了,一次正則匹配拿到值。缺點是每次取一個參數就要跑一次正則,取多個參數時效率較低;而且返回值仍然沒有解碼。
function GetUrlParms(name) {
var reg = new RegExp("(^|&)" + name + "=([^&]*)(&|$)", "i");
if (reg.test(location.href)) {
return unescape(RegExp.$2.replace(/\+/g, " "));
}
return "";
}
這裡用 RegExp.$2 取第二個捕獲組,並把 + 還原成空格(表單編碼中空格會被編碼為加號)。unescape 已廢棄,應改用 decodeURIComponent。此外 (^|&) 這個前綴很重要,能避免 name 誤匹配到 username 之類的參數。
var getQuery = function (i) {
var j = location.search.match(new RegExp("[?&]" + i + "=([^&]*)(&?)", "i"));
return j ? j[1] : j;
};
// 調用
<a href="#" onclick="test1();">獲取參數值</a>
<script>
var test1 = function () {
alert("v4=" + getQuery("name"));
};
</script>
三行代碼完成同樣的事,是這幾種手工方案裡最優雅的。
所有這些代碼今天都可以扔掉了。所有現代瀏覽器都支持 URLSearchParams:
// 讀取單個參數
var params = new URLSearchParams(location.search);
var name = params.get('name');
// 判斷是否存在(區分「沒有這個參數」和「參數值為空」)
params.has('name'); // true / false
// 取所有同名參數(比如多選的 checkbox)
params.getAll('color'); // ['red', 'blue']
// 遍歷所有參數
params.forEach(function (value, key) {
console.log(key + ' = ' + value);
});
// 修改並同步回地址欄
params.set('page', '2');
history.replaceState(null, '', '?' + params.toString());
它自動處理 URL 解碼、自動處理 + 與空格的轉換、自動處理重複參數,邊界情況全部照顧到了。如果需要兼容更老的環境(IE11),可以引入同名 polyfill,或者用 URLSearchParams 加特性檢測降級到方式四。
順帶提一個實務建議:把解析邏輯封裝成一個函數,全項目只留一處,比在需要的地方到處複製貼上這段代碼要可靠得多。參數名也建議集中定義為常量,避免各處手寫字符串拼錯。