萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網頁製作 >> 網頁設計

JavaScript 獲取 URL 參數值的 3 種方法:從正則解析到 URLSearchParams 現代標準

URL 參數解析:從手工切割到原生 API

在目標頁面通過 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"

方法三:URLSearchParams 原生 API(現代標準,強烈推薦)

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)極小完整 (多值、編碼、構建、迭代)⭐⭐⭐⭐⭐ (新項目首選)

進階:TypeScript 類型安全封裝

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;
}
copyright © 萬盛學電腦網 all rights reserved