URLSearchParams (推薦)現代瀏覽器(IE 不支援)原生提供 URLSearchParams API,操作查詢字串極其方便:
// 當前頁面 URL: https://example.com/page?name=xyz&age=20
const params = new URLSearchParams(window.location.search);
params.get('name'); // 'xyz'
params.get('age'); // '20'
params.get('not-exist'); // null
params.has('name'); // true
params.set('name', 'abc'); // 修改
params.append('tag', 'js'); // 新增同名參數
params.toString(); // 'name=abc&age=20&tag=js' (可用於 history.replaceState)
params.delete('age');
/**
* 獲取 URL 查詢參數值
* @param {string} name 參數名
* @param {string} [url=window.location.href] 可選目標 URL
* @returns {string|null} 解碼後的值,不存在返回 null
*/
function getQueryString(name, url) {
url = url || window.location.href;
// 兼容 hash 路由:去除 # 後內容
var hashIndex = url.indexOf('#');
if (hashIndex !== -1) url = url.slice(0, hashIndex);
var queryStart = url.indexOf('?');
if (queryStart === -1) return null;
var queryString = url.slice(queryStart + 1);
// 手動解析 (避免正則性能/邊界問題)
var pairs = queryString.split('&');
for (var i = 0; i < pairs.length; i++) {
var pair = pairs[i].split('=');
var key = decodeURIComponent(pair[0]);
if (key === name) {
return pair.length > 1 ? decodeURIComponent(pair[1]) : '';
}
}
return null;
}
// 使用
var name = getQueryString('name'); // 'xyz'
console.log(name);
function getQueryStringReg(name) {
var reg = new RegExp('(^|&)' + name.replace(/[.*+?^${}()|[\]\\]/g, '\\$&') + '=([^&]*)(&|$)', 'i');
var r = window.location.search.substr(1).match(reg);
return r ? decodeURIComponent(r[2]) : null;
}
function getAllParams(url) {
url = url || window.location.href;
var queryStart = url.indexOf('?');
if (queryStart === -1) return {};
var queryString = url.slice(queryStart + 1);
var params = {};
queryString.split('&').forEach(function(pair) {
var kv = pair.split('=');
var key = decodeURIComponent(kv[0]);
var val = kv.length > 1 ? decodeURIComponent(kv[1]) : '';
// 同名參數:覆蓋或存陣列
if (params[key] !== undefined) {
params[key] = [].concat(params[key], val);
} else {
params[key] = val;
}
});
return params;
}
// URL: #/page?name=abc
var hashParams = new URLSearchParams(location.hash.split('?')[1] || '');
var name = hashParams.get('name');
function setQueryParam(key, value) {
var url = new URL(window.location.href);
url.searchParams.set(key, value);
window.history.replaceState({}, '', url); // 或 pushState 添加歷史記錄
}
URLSearchParams**,乾淨、標準、無依賴。URL + history.replaceState,保持單頁應用體驗。