萬盛學電腦網

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

JavaScript 獲取 URL 參數的通用函式:相容性最佳實踐與現代 URLSearchParams 方案

傳統相容性寫法(支援 IE6+)

function getQueryParam(name) {
    // 1. 取得查詢字串(去掉開頭 ?)
    var query = window.location.search.substring(1);

    // 2. 分割成鍵值對陣列
    var pairs = query.split('&');
    var params = {};

    // 3. 解析每組 key=value
    for (var i = 0; i < pairs.length; i++) {
        var pair = pairs[i].split('=');
        if (pair.length === 2) {
            var key = decodeURIComponent(pair[0]).toLowerCase();
            var val = decodeURIComponent(pair[1]);
            params[key] = val;
        }
    }

    // 4. 回傳指定參數(不區分大小寫)
    return params[name.toLowerCase()] || '';
}

// 使用範例
var url = getQueryParam('url');
var img = getQueryParam('img');
if (url && img) {
    document.write('<a href="' + url + '" target="_blank"><img src="' + img + '" width="750" height="450"></a>');
}

關鍵細節說明

  1. decodeURIComponent:正確處理中文、特殊字元編碼
  2. toLowerCase():參數名不區分大小寫比對
  3. || '':參數不存在時回傳空字串,避免 undefined 錯誤
  4. 避免正則:雖然正則寫法短,但舊瀏覽器效能差且邊界情況多

現代標準方案:URLSearchParams(IE 不支援)

// 現代瀏覽器一行搞定
const params = new URLSearchParams(window.location.search);
const url = params.get('url');      // 取單一值
const allTags = params.getAll('tag'); // 取同名參數所有值(陣列)
const hasId = params.has('id');     // 檢查是否存在

// 迭代所有參數
for (const [key, value] of params) {
    console.log(key, value);
}

Polyfill 方案:引入 url-search-params-polyfill 即可在舊瀏覽器使用。

進階:解析雜湊參數

function getHashParams() {
    var hash = window.location.hash.substring(1); // 去掉 #
    return new URLSearchParams(hash); // 同樣適用
}

完整工具函式庫版本

const UrlUtil = {
    getParam(name, url = window.location.href) {
        const search = new URL(url).search;
        return new URLSearchParams(search).get(name);
    },
    getAllParams(url = window.location.href) {
        const search = new URL(url).search;
        const params = {};
        for (const [k, v] of new URLSearchParams(search)) {
            params[k] = v;
        }
        return params;
    },
    setParam(name, value, url = window.location.href) {
        const u = new URL(url);
        u.searchParams.set(name, value);
        return u.href;
    },
    removeParam(name, url = window.location.href) {
        const u = new URL(url);
        u.searchParams.delete(name);
        return u.href;
    }
};

// 使用
const id = UrlUtil.getParam('id');
const newUrl = UrlUtil.setParam('page', 2);

總結

  • 需支援 IE → 使用傳統 split/decodeURIComponent 寫法
  • 現代專案 → 直接用 URLSearchParams,語意清晰、API 豐富
  • 封裝通用工具類,統一專案參數處理風格
copyright © 萬盛學電腦網 all rights reserved