在目標頁面通過 window.location.search 獲取查詢字符串(如 ?id=123&name=abc),提取所需參數值是前端高頻需求。本文對比 3 種方案,推薦現代標準 API。
function getUrlParams() {
var search = window.location.search; // "?id=123&name=abc"
if (!search) return {};
return search.slice(1).split('&').reduce(function(params, pair) {
var kv = pair.split('=');
var key = decodeURIComponent(kv[0]);
var val = decodeURIComponent(kv[1] || '');
params[key] = val;
return params;
}, {});
}
// 使用
var params = getUrlParams();
console.log(params.id); // "123"
console.log(params.name); // "abc"
function GetQuery(key) {
var search = location.search.slice(1); // 去掉 '?'
var arr = search.split("&");
for (var i = 0; i < arr.length; i++) {
var kv = arr[i].split("=");
if (kv[0] === key) {
return decodeURIComponent(kv[1] || '');
}
}
return null;
}
// 頁面加載時調用
var opt = GetQuery('opt'); // URL: ?opt=1 → 返回 "1"
IE 不支援,但可用 Polyfill 兼容。
// 獲取 URLSearchParams 實例
var params = new URLSearchParams(window.location.search);
// 獲取單值
var id = params.get('id'); // "123"
var name = params.get('name'); // "abc"
// 獲取同名多值 (如 ?tag=js&tag=css)
var tags = params.getAll('tag'); // ["js", "css"]
// 判斷是否存在
params.has('id'); // true
// 遍歷所有
params.forEach(function(value, key) {
console.log(key, value);
});
// 轉為對象 (單值場景)
var obj = Object.fromEntries(params); // {id: "123", name: "abc"}
// 構建新查詢字符串
params.set('page', 2);
params.append('tag', 'html5');
var newSearch = params.toString(); // "id=123&name=abc&page=2&tag=html5"
history.replaceState(null, '', '?' + newSearch); // 更新 URL 不刷新頁面
| 方案 | 瀏覽器支援 | 代碼量 | 功能完整度 | 推薦指數 |
|---|---|---|---|---|
| 手工分割 | 全瀏覽器 | 大 | 基礎 | ⭐ (維舊專用) |
| 封裝函數 GetQuery | 全瀏覽器 | 中 | 基礎 | ⭐⭐ (快速引入) |
| URLSearchParams | 現代瀏覽器 (IE 需 Polyfill) | 極小 | 完整 (多值、編碼、構建、迭代) | ⭐⭐⭐⭐⭐ (新項目首選) |
interface QueryParams {
[key: string]: string | string[];
}
function getParams(): QueryParams {
const params = new URLSearchParams(window.location.search);
const result: QueryParams = {};
for (const [key, value] of params) {
if (result[key]) {
result[key] = Array.isArray(result[key])
? [...result[key], value]
: [result[key], value];
} else {
result[key] = value;
}
}
return result;
}