做前端的朋友大概都有過這樣的經歷:需要改動網址列上的某個查詢參數,於是憑直覺寫了幾行字串處理,當場看起來沒問題,換幾個頁面就各種漏字、重複拼接,出錯了還不知道該從哪裡查起。與其反覆碰運氣,不如把這件事收攏成一個可重複使用的方法。
早期沒有現成的 API,只能靠正則運算式的比對與替換來完成。思路很直白:先用參數名組出一個匹配規則,看網址裡有沒有這個參數;有的話就替換掉它的值,沒有的話再判斷網址中是否已經帶有問號,決定用 & 還是 ? 接上去。
function changeURLPar(destiny, par, par_value) {
var pattern = par + '=([^&]*)';
var replaceText = par + '=' + par_value;
if (destiny.match(pattern)) {
var tmp = '/\' + par + '=[^&]*/';
tmp = destiny.replace(eval(tmp), replaceText);
return tmp;
} else {
if (destiny.match('[\?]')) {
return destiny + '&' + replaceText;
} else {
return destiny + '?' + replaceText;
}
}
}
三個參數的分工是:destiny 是目標網址字串,par 是參數名,par_value 是要寫入的新值。以 https://www.huistd.com/?id=3&ttt=3 為例:
changeURLPar(test, 'id', 99); // https://www.huistd.com/?id=99&ttt=3 changeURLPar(test, 'haha', 33); // https://www.huistd.com/?id=99&ttt=3&haha=33
這個寫法能用,但所以有幾個明顯的隱憂:用了 eval 動態組招式,既慢又不安全;參數名若含有正則的保留字元(例如 .、?)會誤匹配;末尾那句 return destiny+'\n'+par+'\n'+par_value; 永遠不會被執行,屬於歷史殘留。
現代瀏覽器普遍支援 URL 與 URLSearchParams,改參數這件事已經不需要自己你啊叨。它的好處是會自動處理編碼、判斷分隔符號,也不會因為參數名裡有特殊字元而誤判。
function changeURLPar(url, par, value) {
var u = new URL(url, window.location.origin);
u.searchParams.set(par, value);
return u.toString();
}
changeURLPar(location.href, 'id', 99);
只需要替換某個參數時用 set;想在不覆蓋既有值的情況下追加,改用 append;要移除則是 delete。若想直接改動當前頁面而不重新載入,可以搭配 history.replaceState:
var u = new URL(location.href);
u.searchParams.set('id', 99);
history.replaceState(null, '', u);
如果專案還需要支援很舊的 IE,那才需要退回正則方案,並且建議至少把 eval 換成 new RegExp(par + '=[^&]*'),同時對參數值做 encodeURIComponent 編碼,避免中文或 & 號把網址結構打壞。
把這類常用動作整理成一個小工具函式,往後遇到類似需求直接呼叫就好,不必每次重新摸索,這才是當初寫下這段方法的真正價值。