萬盛學電腦網

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

jQuery / 原生 JS 取得 URL 參數(Query String)完整工具函式

現代標準做法:URLSearchParams (ES2015+)

// 取得單一參數
function getParam(name) {
    return new URLSearchParams(window.location.search).get(name);
}

// 取得所有參數為物件
function getAllParams() {
    const params = {};
    for (const [k, v] of new URLSearchParams(window.location.search)) {
        params[k] = v;
    }
    return params;
}

// 使用
const classId = getParam('classid');
const id = getParam('id');
console.log(getAllParams()); // {classid: "123", id: "456"}

優點:原生、無依賴、自動處理編碼/解碼、支援多值同鍵(.getAll())。
支援度:所有現代瀏覽器(IE 需 Polyfill)。

相容舊瀏覽器:純 JS 解析函式(無依賴)

/**
 * 解析 URL 參數
 * @param {string} url - 可選,預設 window.location.href
 * @returns {Object} 參數鍵值對(小寫鍵名)
 */
function parseQueryString(url = window.location.href) {
    const queryStart = url.indexOf('?');
    if (queryStart === -1) return {};

    const queryString = url.slice(queryStart + 1);
    // 移除 hash 部分
    const hashStart = queryString.indexOf('#');
    const pureQuery = hashStart !== -1 ? queryString.slice(0, hashStart) : queryString;

    const params = {};
    pureQuery.split('&').forEach(pair => {
        if (!pair) return;
        const eqIdx = pair.indexOf('=');
        const key = decodeURIComponent(eqIdx === -1 ? pair : pair.slice(0, eqIdx)).toLowerCase();
        const value = eqIdx === -1 ? '' : decodeURIComponent(pair.slice(eqIdx + 1));
        // 同名參數取最後一個(或可改陣列收集)
        params[key] = value;
    });
    return params;
}

/** 取得單一參數(不區分大小寫) */
function request(paramName) {
    return parseQueryString()[paramName.toLowerCase()] || '';
}

jQuery 專用版(若專案已引入 jQuery)

$.urlParam = function(name) {
    const results = new RegExp('[?&]' + name.replace(/[\[\]]/g, '\\$&') + '=([^&#]*)').exec(window.location.href);
    return results === null ? '' : decodeURIComponent(results[1].replace(/\+/g, ' '));
};

// 使用
const classid = $.urlParam('classid');

進階:支援陣列參數 ?ids=1&ids=2

function parseQueryStringArray(url = window.location.href) {
    const params = {};
    new URLSearchParams(url.split('?')[1] || '').forEach((v, k) => {
        const key = k.toLowerCase();
        if (params[key] === undefined) params[key] = v;
        else if (Array.isArray(params[key])) params[key].push(v);
        else params[key] = [params[key], v];
    });
    return params;
}
// 結果:{ids: ["1", "2"]}

實務應用範例

<script>
// 1. 依參數決定初始化邏輯
const tab = request('tab') || 'home';
initTab(tab);

// 2. 保留參數重導向
function redirectWithParams(newPath, extraParams = {}) {
    const params = {...parseQueryString(), ...extraParams};
    const qs = Object.entries(params).map(([k,v]) => `${encodeURIComponent(k)}=${encodeURIComponent(v)}`).join('&');
    location.href = `${newPath}?${qs}`;
}

// 3. 表單預填
document.addEventListener('DOMContentLoaded', () => {
    const params = parseQueryString();
    Object.entries(params).forEach(([k, v]) => {
        const el = document.querySelector(`[name="${k}"]`);
        if (el) el.value = v;
    });
});
</script>

效能與安全提醒

  • 解析結果建議快取,避免重複呼叫 parseQueryString()。
  • 參數值直接輸出到 HTML/JS 時務必 encodeURIComponent 或用 textContent 防 XSS。
  • 敏感資訊(Token、密碼)勿放在 URL 參數,應用 Header 或 Body 傳遞。
copyright © 萬盛學電腦網 all rights reserved