URL 參數包含中文:?pkId=123&name=張三。直接 location.search 解析得到的中文可能為編碼後的 %E5%BC%A0%E4%B8%89 或亂碼(視頁面編碼而定),需統一解碼。
/**
* 解析 URL 參數為對象,自動 decodeURIComponent
* @returns {Object} { paramName: decodedValue, ... }
*/
function getUrlParams() {
var params = {};
var search = window.location.search.substring(1); // 去掉 '?'
if (!search) return params;
var pairs = search.split('&');
for (var i = 0; i < pairs.length; i++) {
var pair = pairs[i].split('=');
var key = decodeURIComponent(pair[0]);
var value = pair.length > 1 ? decodeURIComponent(pair[1]) : '';
// 同名參數:數組化
if (params.hasOwnProperty(key)) {
if (!Array.isArray(params[key])) params[key] = [params[key]];
params[key].push(value);
} else {
params[key] = value;
}
}
return params;
}
var params = getUrlParams();
var pkId = params.pkId; // "123"
var name = params.name; // "張三" (已解碼)
// 兼容舊代碼風格:params[params[0]] 等
// 不推薦,語義不清
| 情況 | 現象 | 處理 |
|---|---|---|
| 頁面 UTF-8,URL 為 UTF-8 編碼 | decodeURIComponent 正常 | 直接用 |
| 頁面 GBK,URL 為 UTF-8 編碼 | decodeURIComponent 產生亂碼 | 頁面統一遷移 UTF-8;或用 iconv 服務端轉碼 |
| 雙重編碼 | %25E5%25BC%25A0 | 雙重 decodeURIComponent 或後端修復 |
| 參數含特殊字符 (+, %, #, &) | 解析錯誤 | 後端 encodeURIComponent 編碼,前端 decodeURIComponent 解碼 |
// 原生支援 IE 無、Edge 12+、Chrome 49+、Firefox 44+
var params = new URLSearchParams(window.location.search);
var pkId = params.get('pkId');
var name = params.get('name'); // 自動解碼
var allNames = params.getAll('name'); // 同名參數數組
// 迭代
params.forEach((value, key) => console.log(key, value));
Polyfill:https://github.com/ungap/url-search-params(~1KB gzip)兼容 IE11+。
function getQueryParams() {
if (window.URLSearchParams) {
return new URLSearchParams(window.location.search);
}
// 降級實現
var obj = {};
var search = window.location.search.slice(1);
search.split('&').forEach(function(pair) {
var idx = pair.indexOf('=');
var key = decodeURIComponent(idx > -1 ? pair.slice(0, idx) : pair);
var val = idx > -1 ? decodeURIComponent(pair.slice(idx + 1)) : '';
obj[key] = val; // 簡化:不處理同名參數數組
});
return {
get: function(k) { return obj[k]; },
getAll: function(k) { var v = obj[k]; return v ? [v] : []; },
forEach: function(fn) { for (var k in obj) fn(obj[k], k); }
};
}
encodeURIComponent** 編碼每個參數值。<meta charset="utf-8">)。URLSearchParams**,引入 Polyfill 兼容舊瀏覽器。標準化參數處理,杜絕中文亂碼與安全隱患。