萬盛學電腦網

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

jQuery 封裝獲取 URL Get 參數工具方法

核心實現


;(function($) {
    $.extend({
        /**
         * 獲取 URL 中的 GET 參數
         * @returns {Object} 鍵值對對象
         * @example
         * // URL: ?id=123&name=abc
         * var GET = $.urlGet();
         * GET.id === "123"
         */
        urlGet: function() {
            const query = window.location.search.substring(1); // 去掉 ?
            if (!query) return {};
            
            const params = {};
            const pairs = query.split('&');
            
            for (let i = 0; i < pairs.length; i++) {
                const pair = pairs[i].split('=');
                const key = decodeURIComponent(pair[0]);
                const value = pair.length > 1 ? decodeURIComponent(pair[1]) : '';
                
                // 處理同名參數(數組化)
                if (params[key] !== undefined) {
                    if (!Array.isArray(params[key])) {
                        params[key] = [params[key]];
                    }
                    params[key].push(value);
                } else {
                    params[key] = value;
                }
            }
            
            return params;
        },
        
        /**
         * 獲取單個參數值
         * @param {String} name - 參數名
         * @param {String} defaultValue - 默認值
         * @returns {String|Array}
         */
        urlParam: function(name, defaultValue = null) {
            const params = $.urlGet();
            return params.hasOwnProperty(name) ? params[name] : defaultValue;
        }
    });
})(jQuery);

使用示例


// URL: https://example.com/page?id=123&tag=js&tag=jquery&name=test

const GET = $.urlGet();
// { id: "123", tag: ["js", "jquery"], name: "test" }

const id = $.urlParam('id');           // "123"
const tags = $.urlParam('tag');        // ["js", "jquery"]
const missing = $.urlParam('none', 'default'); // "default"

原生 JS 現代實現(無依賴)


// URLSearchParams API(現代瀏覽器原生支援)
const params = new URLSearchParams(window.location.search);

params.get('id');           // "123" - 取第一個
params.getAll('tag');       // ["js", "jquery"] - 取所有
params.has('name');         // true
params.toString();          // "id=123&tag=js&tag=jquery&name=test"

// 封裝通用函數
function getUrlParams(search = window.location.search) {
    const params = new URLSearchParams(search);
    const result = {};
    for (const [key, value] of params) {
        if (result[key] !== undefined) {
            result[key] = Array.isArray(result[key]) ? [...result[key], value] : [result[key], value];
        } else {
            result[key] = value;
        }
    }
    return result;
}

進階:參數設置與 URL 構建


// 設置/更新參數
function setUrlParam(key, value, replace = true) {
    const url = new URL(window.location.href);
    if (value === null || value === undefined) {
        url.searchParams.delete(key);
    } else {
        if (replace) url.searchParams.set(key, value);
        else url.searchParams.append(key, value);
    }
    const newUrl = url.toString();
    if (replace) history.replaceState(null, '', newUrl);
    else history.pushState(null, '', newUrl);
    return newUrl;
}

// 構建帶參數 URL
function buildUrl(base, params) {
    const url = new URL(base);
    Object.entries(params).forEach(([k, v]) => {
        if (Array.isArray(v)) v.forEach(val => url.searchParams.append(k, val));
        else url.searchParams.set(k, v);
    });
    return url.toString();
}

// 使用
buildUrl('/search', { q: 'js', tag: ['jquery', 'vue'], page: 1 });
// "/search?q=js&tag=jquery&tag=vue&page=1"

兼容性說明

APIIEEdgeChromeFirefoxSafari
URLSearchParams❌17+49+44+10.1+
URL❌12+32+26+10+

IE 環境需引入 Polyfill 或使用傳統字符串解析。

copyright © 萬盛學電腦網 all rights reserved