從網址抓參數是再日常不過的需求。用正則表達式一次比對,是相當乾淨的寫法:
function getQueryString(name) {
var reg = new RegExp("(^|&)" + name + "=([^&]*)(&|$)", "i");
var r = location.search.substr(1).match(reg);
if (r != null) return unescape(decodeURI(r[2]));
return null;
}
(^|&) 比對「字串開頭或 &」,確保參數名稱是完整的一段,不會把 page 誤配到 userpage 裡。
name= 是參數名稱本身。
([^&]*) 用括號捕獲參數值,除了 & 之外什麼都能吃。
(&|$) 比對「& 或字串結尾」,作為右邊界。
i 旗標讓比對不區分大小寫。location.search.substr(1) 去掉開頭的問號,這樣 ^ 才能對應到第一個參數。
範例中 unescape(decodeURI(r[2])) 的組合是為了處理中文:先 decodeURI 把編碼還原,再用 unescape 處理 UTF-8 位元組序列。這是個歷史悠久的折衷寫法,能運作但不理想。
標準做法是 decodeURIComponent,它能正確處理 UTF-8:
return decodeURIComponent(r[2]);
要注意 decodeURIComponent 遇到格式錯誤的編碼會丟出 URIError,實務上建議包一層:
try {
return decodeURIComponent(r[2]);
} catch (e) {
return r[2];
}
這個方法預設回傳的是字串。若需要整數,使用前要自行轉換:
var page = parseInt(getQueryString('page'), 10);
if (isNaN(page) || page < 1) page = 1; // 記得給預設值
補上 isNaN 檢查與預設值很重要——參數不存在時函式回傳 null,直接 parseInt(null) 會得到 NaN,後續計算就全亂了。
今天的瀏覽器都支援 URLSearchParams,不必再手寫正則:
var params = new URLSearchParams(location.search);
var page = params.get('page'); // 取單一參數
var all = params.getAll('tag'); // 取同名多值
var has = params.has('keyword'); // 判斷是否存在
// 修改參數
params.set('page', 3);
var newSearch = params.toString(); // "page=3&..."
它自動處理編碼解碼、支援重複參數、也能遍歷。若要修改網址而不重新載入頁面,搭配 history API 使用:
var params = new URLSearchParams(location.search);
params.set('page', 3);
history.pushState({}, '', location.pathname + '?' + params.toString());
手寫版本的價值在於理解參數解析的原理——邊界錨定、捕獲組、編碼還原——但真正開發時請用 URLSearchParams,它更少出錯也更好讀。