在網站開發中,經常需要處理網址中的查詢參數,例如讀取使用者輸入、更新篩選條件或建立分享連結。使用 URLSearchParams 可以讓這些操作變得更清楚、更安全。
function getQueryString(name) {
var params = new URLSearchParams(window.location.search);
return params.get(name);
}
這個方法會回傳指定參數的值,若不存在則回傳 null。
function replaceParamVal(url, paramName, replaceWith) {
var u = new URL(url, window.location.origin);
u.searchParams.set(paramName, replaceWith);
return u.toString();
}
使用 URL 物件搭配 searchParams.set,可以自動處理編碼與格式問題。
如果需要新增參數,概念與替換相同:
function updateUrlWithParam(url, key, value) {
var u = new URL(url, window.location.origin);
u.searchParams.set(key, value);
return u.toString();
}
若 key 已存在,set 會更新其值;若不存在,則會新增。
早期常使用正規表達式或字串取代來處理網址,但容易忽略編碼、特殊字元與邊界條件。使用 URLSearchParams 能讓程式碼更直覺,也能減少錯誤。
處理 URL 時,優先使用瀏覽器原生的 URL 與 URLSearchParams API,不僅可讀性高,也更符合現代前端開發實務。