萬盛學電腦網

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

JavaScript 獲取 URL 中文參數並解碼處理

問題場景

URL 參數包含中文:?pkId=123&name=張三。直接 location.search 解析得到的中文可能為編碼後的 %E5%BC%A0%E4%B8%89 或亂碼(視頁面編碼而定),需統一解碼。

通用獲取參數函數

/**
 * 解析 URL 參數為對象,自動 decodeURIComponent
 * @returns {Object} { paramName: decodedValue, ... }
 */
function getUrlParams() {
    var params = {};
    var search = window.location.search.substring(1); // 去掉 '?'
    if (!search) return params;

    var pairs = search.split('&');
    for (var i = 0; i < pairs.length; i++) {
        var pair = pairs[i].split('=');
        var key = decodeURIComponent(pair[0]);
        var value = pair.length > 1 ? decodeURIComponent(pair[1]) : '';
        // 同名參數:數組化
        if (params.hasOwnProperty(key)) {
            if (!Array.isArray(params[key])) params[key] = [params[key]];
            params[key].push(value);
        } else {
            params[key] = value;
        }
    }
    return params;
}

使用示例

var params = getUrlParams();
var pkId = params.pkId;           // "123"
var name = params.name;           // "張三" (已解碼)

// 兼容舊代碼風格:params[params[0]] 等
// 不推薦,語義不清

編碼陷阱與對策

情況現象處理
頁面 UTF-8,URL 為 UTF-8 編碼decodeURIComponent 正常直接用
頁面 GBK,URL 為 UTF-8 編碼decodeURIComponent 產生亂碼頁面統一遷移 UTF-8;或用 iconv 服務端轉碼
雙重編碼%25E5%25BC%25A0雙重 decodeURIComponent 或後端修復
參數含特殊字符 (+, %, #, &)解析錯誤後端 encodeURIComponent 編碼,前端 decodeURIComponent 解碼

現代 API:URLSearchParams(推薦)

// 原生支援 IE 無、Edge 12+、Chrome 49+、Firefox 44+
var params = new URLSearchParams(window.location.search);
var pkId = params.get('pkId');
var name = params.get('name'); // 自動解碼
var allNames = params.getAll('name'); // 同名參數數組

// 迭代
params.forEach((value, key) => console.log(key, value));

Polyfill:https://github.com/ungap/url-search-params(~1KB gzip)兼容 IE11+。

完整工具函數(含 Polyfill 判斷)

function getQueryParams() {
    if (window.URLSearchParams) {
        return new URLSearchParams(window.location.search);
    }
    // 降級實現
    var obj = {};
    var search = window.location.search.slice(1);
    search.split('&').forEach(function(pair) {
        var idx = pair.indexOf('=');
        var key = decodeURIComponent(idx > -1 ? pair.slice(0, idx) : pair);
        var val = idx > -1 ? decodeURIComponent(pair.slice(idx + 1)) : '';
        obj[key] = val; // 簡化:不處理同名參數數組
    });
    return {
        get: function(k) { return obj[k]; },
        getAll: function(k) { var v = obj[k]; return v ? [v] : []; },
        forEach: function(fn) { for (var k in obj) fn(obj[k], k); }
    };
}

最佳實踐

  1. **後端生成 URL 時用 encodeURIComponent** 編碼每個參數值。
  2. **前端頁面強制 UTF-8**(<meta charset="utf-8">)。
  3. **優先使用 URLSearchParams**,引入 Polyfill 兼容舊瀏覽器。
  4. **避免手寫解析邏輯**,易漏處理邊界情況(空值、特殊字符、同名參數)。

標準化參數處理,杜絕中文亂碼與安全隱患。

copyright © 萬盛學電腦網 all rights reserved