DIV CSS 佈局教程網

用 urlArgs 函式提取網址查詢字串中的參數
編輯:關於JavaScript     

在《JavaScript 權威指南》(犀牛書)中看到一個很實用的小函式 urlArgs,專門用來解析網址中的查詢字串。

我們常看到頁面連結後面帶著參數,例如 https://www.xxx.com/?username=yyy&password=zzz。很多時候需要取得這些值(yyy 與 zzz),這時就可以用 urlArgs(),它會回傳一個物件,透過屬性名稱取值即可。

urlArgs 函式

function urlArgs(){
  var args = {};
  var query = location.search.substring(1);   // 去掉最前面的 "?"
  var pairs = query.split('&');               // 每個 "name=value" 一組
  for (var i = 0; i < pairs.length; i++){
    var pos = pairs[i].indexOf('=');
    if (pos == -1) continue;                  // 沒有 = 的片段直接跳過
    var name  = pairs[i].substring(0, pos);
    var value = pairs[i].substring(pos + 1);
    value = decodeURIComponent(value);        // 還原 %xx 編碼
    args[name] = value;
  }
  return args;
}

使用方式

var args = urlArgs();
var username = args.username;   // yyy
var password = args.password;   // zzz

幾個實作細節

用 indexOf('=') 而非 split('=')。若值本身含有等號(例如 base64 編碼的 token 結尾常有 =),用 split 會被切成多段而遺失內容;用 indexOf 只切第一個等號,其餘原樣保留,更穩妥。

decodeURIComponent 是必要的。中文、空白與特殊符號在網址中會被編碼成 %E4%B8%AD 這類形式,不解碼拿到的會是亂碼。

若要更完整,可再加兩件事:一是遇到 name 重複時,把值收進陣列(HTML 多選或同名的多個參數會這樣出現);二是若頁面使用 hash 路由,記得一併處理 location.hash 中的 ? 後段。

而在現代專案中,直接用原生 API 會更簡潔:

var params = new URLSearchParams(location.search);
var username = params.get('username');
var password = params.get('password');

URLSearchParams 已自動處理解碼、重複鍵與空值等邊界情況,是首選方案。urlArgs 的價值則在於它清楚展示了解析的每個步驟,讀懂它之後再使用原生 API 會更有底氣。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved