萬盛學電腦網

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

JavaScript 解析與設置 URL 參數(Query String)工具函數封裝

URL 參數處理是前端路由、分享鏈接、埋點上報的高頻需求。本文封裝兩個純函數:getUrlParams() 解析整個查詢字符串為鍵值對數組,getParamValue(name) 精確取值,兼容重複鍵、特殊字符場景。

核心工具函數

/**
 * 解析 location.search 返回參數對象數組
 * 格式:[{key1: val1}, {key2: val2}, ...] 保留重複鍵順序
 */
function getUrlParams() {
    var search = window.location.search; // "?a=1&b=2"
    if (!search) return [];
    // 去掉首字符 '?',按 '&' 分割
    var pairs = search.substring(1).split("&");
    var paramsArray = [];
    for (var i = 0; i < pairs.length; i++) {
        var pair = pairs[i];
        // 僅在第一個 '=' 分割,值中可能包含 '='
        var idx = pair.indexOf('=');
        var key = idx > -1 ? pair.substring(0, idx) : pair;
        var val = idx > -1 ? pair.substring(idx + 1) : '';
        // URL 解碼
        key = decodeURIComponent(key);
        val = decodeURIComponent(val);
        var obj = {};
        obj[key] = val;
        paramsArray.push(obj);
    }
    return paramsArray;
}

/**
 * 根據參數名獲取第一個匹配的值
 */
function getParamValue(name) {
    var params = getUrlParams();
    for (var i = 0; i < params.length; i++) {
        for (var key in params[i]) {
            if (key === name) return params[i][key];
        }
    }
    return null; // 不存在
}

使用示例

// 假設 URL: https://example.com/page?id=123&tag=js&tag=frontend&name=test%20value
var id = getParamValue('id');       // "123"
var tag = getParamValue('tag');     // "js" (取第一個)
var name = getParamValue('name');   // "test value" (自動解碼)
var none = getParamValue('none');   // null

現代標準 API:URLSearchParams(推薦生產環境)

// 原生支持:Chrome 49+, FF 44+, Safari 10.1+, Edge 17+
var params = new URLSearchParams(window.location.search);
params.get('id');           // "123" (首個)
params.getAll('tag');       // ["js", "frontend"] (所有值)
params.has('name');         // true
params.set('id', '456');    // 修改
params.append('tag', 'vue'); // 新增
params.toString();          // "id=456&tag=js&tag=frontend&tag=vue&name=test+value"

// 兼容性:IE 不支持,需引入 polyfill (core-js/stable/url-search-params)

進階封裝:URLParams 類(支援鏈式、修改、序列化)

class URLParams {
    constructor(search = window.location.search) {
        this.params = new URLSearchParams(search);
    }
    get(name) { return this.params.get(name); }
    getAll(name) { return this.params.getAll(name); }
    set(name, value) { this.params.set(name, value); return this; }
    append(name, value) { this.params.append(name, value); return this; }
    delete(name) { this.params.delete(name); return this; }
    toString() { return this.params.toString(); }
    toObj() { 
        var obj = {}; 
        for (var [k, v] of this.params) obj[k] = v; // 最後一個值
        return obj; 
    }
}

// 用法
var u = new URLParams();
u.set('page', 2).append('sort', 'desc');
history.replaceState(null, '', '?' + u.toString()); // 更新地址欄不刷新

掌握原生 URLSearchParams 可大幅簡化參數操作代碼,老項目可用上述 ES5 封裝過渡。

copyright © 萬盛學電腦網 all rights reserved