萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

JavaScript 獲取 URL 查詢參數的標準方法:URLSearchParams 與兼容方案

現代標準:URLSearchParams (推薦)

現代瀏覽器(IE 不支援)原生提供 URLSearchParams API,操作查詢字串極其方便:

// 當前頁面 URL: https://example.com/page?name=xyz&age=20
const params = new URLSearchParams(window.location.search);

params.get('name');        // 'xyz'
params.get('age');         // '20'
params.get('not-exist');   // null
params.has('name');        // true
params.set('name', 'abc'); // 修改
params.append('tag', 'js'); // 新增同名參數
params.toString();         // 'name=abc&age=20&tag=js' (可用於 history.replaceState)
params.delete('age');

通用兼容函數(支援 IE9+)

/**
 * 獲取 URL 查詢參數值
 * @param {string} name 參數名
 * @param {string} [url=window.location.href] 可選目標 URL
 * @returns {string|null} 解碼後的值,不存在返回 null
 */
function getQueryString(name, url) {
  url = url || window.location.href;
  // 兼容 hash 路由:去除 # 後內容
  var hashIndex = url.indexOf('#');
  if (hashIndex !== -1) url = url.slice(0, hashIndex);

  var queryStart = url.indexOf('?');
  if (queryStart === -1) return null;
  var queryString = url.slice(queryStart + 1);

  // 手動解析 (避免正則性能/邊界問題)
  var pairs = queryString.split('&');
  for (var i = 0; i < pairs.length; i++) {
    var pair = pairs[i].split('=');
    var key = decodeURIComponent(pair[0]);
    if (key === name) {
      return pair.length > 1 ? decodeURIComponent(pair[1]) : '';
    }
  }
  return null;
}

// 使用
var name = getQueryString('name'); // 'xyz'
console.log(name);

正則版本(簡潔但需注意特殊字元轉義)

function getQueryStringReg(name) {
  var reg = new RegExp('(^|&)' + name.replace(/[.*+?^${}()|[\]\\]/g, '\\$&') + '=([^&]*)(&|$)', 'i');
  var r = window.location.search.substr(1).match(reg);
  return r ? decodeURIComponent(r[2]) : null;
}

獲取所有參數轉為物件

function getAllParams(url) {
  url = url || window.location.href;
  var queryStart = url.indexOf('?');
  if (queryStart === -1) return {};
  var queryString = url.slice(queryStart + 1);
  var params = {};
  queryString.split('&').forEach(function(pair) {
    var kv = pair.split('=');
    var key = decodeURIComponent(kv[0]);
    var val = kv.length > 1 ? decodeURIComponent(kv[1]) : '';
    // 同名參數:覆蓋或存陣列
    if (params[key] !== undefined) {
      params[key] = [].concat(params[key], val);
    } else {
      params[key] = val;
    }
  });
  return params;
}

在 Hash 模式路由中獲取參數

// URL: #/page?name=abc
var hashParams = new URLSearchParams(location.hash.split('?')[1] || '');
var name = hashParams.get('name');

修改 URL 參數不刷新頁面

function setQueryParam(key, value) {
  var url = new URL(window.location.href);
  url.searchParams.set(key, value);
  window.history.replaceState({}, '', url); // 或 pushState 添加歷史記錄
}

總結建議

  • 現代專案:**直接使用 URLSearchParams**,乾淨、標準、無依賴。
  • 需兼容 IE:引入 polyfill 或使用上述手動解析函數。
  • 避免手寫正則解析,邊界情況多(編碼、特殊字元、重複鍵、Hash 路由)。
  • 修改 URL 參數用 URL + history.replaceState,保持單頁應用體驗。
copyright © 萬盛學電腦網 all rights reserved