URL 參數處理是前端路由、分享鏈接、埋點上報的高頻需求。本文封裝兩個純函數:getUrlParams() 解析整個查詢字符串為鍵值對數組,getParamValue(name) 精確取值,兼容重複鍵、特殊字符場景。
/**
* 解析 location.search 返回參數對象數組
* 格式:[{key1: val1}, {key2: val2}, ...] 保留重複鍵順序
*/
function getUrlParams() {
var search = window.location.search; // "?a=1&b=2"
if (!search) return [];
// 去掉首字符 '?',按 '&' 分割
var pairs = search.substring(1).split("&");
var paramsArray = [];
for (var i = 0; i < pairs.length; i++) {
var pair = pairs[i];
// 僅在第一個 '=' 分割,值中可能包含 '='
var idx = pair.indexOf('=');
var key = idx > -1 ? pair.substring(0, idx) : pair;
var val = idx > -1 ? pair.substring(idx + 1) : '';
// URL 解碼
key = decodeURIComponent(key);
val = decodeURIComponent(val);
var obj = {};
obj[key] = val;
paramsArray.push(obj);
}
return paramsArray;
}
/**
* 根據參數名獲取第一個匹配的值
*/
function getParamValue(name) {
var params = getUrlParams();
for (var i = 0; i < params.length; i++) {
for (var key in params[i]) {
if (key === name) return params[i][key];
}
}
return null; // 不存在
}
// 假設 URL: https://example.com/page?id=123&tag=js&tag=frontend&name=test%20value
var id = getParamValue('id'); // "123"
var tag = getParamValue('tag'); // "js" (取第一個)
var name = getParamValue('name'); // "test value" (自動解碼)
var none = getParamValue('none'); // null
// 原生支持:Chrome 49+, FF 44+, Safari 10.1+, Edge 17+
var params = new URLSearchParams(window.location.search);
params.get('id'); // "123" (首個)
params.getAll('tag'); // ["js", "frontend"] (所有值)
params.has('name'); // true
params.set('id', '456'); // 修改
params.append('tag', 'vue'); // 新增
params.toString(); // "id=456&tag=js&tag=frontend&tag=vue&name=test+value"
// 兼容性:IE 不支持,需引入 polyfill (core-js/stable/url-search-params)
class URLParams {
constructor(search = window.location.search) {
this.params = new URLSearchParams(search);
}
get(name) { return this.params.get(name); }
getAll(name) { return this.params.getAll(name); }
set(name, value) { this.params.set(name, value); return this; }
append(name, value) { this.params.append(name, value); return this; }
delete(name) { this.params.delete(name); return this; }
toString() { return this.params.toString(); }
toObj() {
var obj = {};
for (var [k, v] of this.params) obj[k] = v; // 最後一個值
return obj;
}
}
// 用法
var u = new URLParams();
u.set('page', 2).append('sort', 'desc');
history.replaceState(null, '', '?' + u.toString()); // 更新地址欄不刷新
掌握原生 URLSearchParams 可大幅簡化參數操作代碼,老項目可用上述 ES5 封裝過渡。