本文整理四種在純 HTML 頁面之間傳遞參數的 JavaScript 寫法,供需要的朋友參考。
在伺服器端,asp、jsp 等程式可以接收表單送出的參數。那麼反過來,能不能傳參數「給」一個 HTML 頁面呢?可以,最通用的做法是透過 URL 的查詢字串,也就是 window.location.href 中 ? 之後的部分。接收端再以 & 分割成多組 key=value 來取值。
/*
* 函數功能:從href獲得參數
* sHref: https://www.cscenter.com.cn/arg.htm?arg1=d&arg2=re
* sArgName: arg1, arg2
* return: the value of arg. d, re
*/
function GetArgsFromHref(sHref, sArgName) {
var args = sHref.split("?");
var retval = "";
if (args[0] == sHref) {
/*參數為空*/
return retval; /*無需做任何處理*/
}
var str = args[1];
args = str.split("&");
for (var i = 0; i < args.length; i ++) {
str = args[i];
var arg = str.split("=");
if (arg.length <= 1) continue;
if (arg[0] == sArgName) retval = arg[1];
}
return retval;
}
這個寫法的優點是接收端不必依賴瀏覽器提供的 location 物件,字串傳進來就能解析,因此也方便寫成測試。缺點是手續多,且用 split("=") 拆解時,若值中含有 = 會被截斷。
function getvalue(name) {
var str = window.location.search;
if (str.indexOf(name) != -1) {
var pos_start = str.indexOf(name) + name.length + 1;
var pos_end = str.indexOf("&", pos_start);
if (pos_end == -1) {
return str.substring(pos_start);
} else {
return str.substring(pos_start, pos_end)
}
} else {
return "沒有這個name值";
}
}
alert(getvalue(name));
這個版本有兩個問題。一是用 indexOf(name) 做比對會誤中——查詢 id 時會命中 user_id,因為 "user_id" 裡含有 "id"。二是 name 變數未經宣告就使用,會丟 ReferenceError。
Request = {
QueryString : function(item){
var svalue = location.search.match(new RegExp("[\\?&]" + item + "=([^&]*)(\\&?)", "i"));
return svalue ? svalue[1] : svalue;
}
}
alert(Request.QueryString("id"));
用 "[\\?&]" 前面加上分隔符的做法修正了方法二的誤中問題——它要求參數名前必須是 ? 或 &。這是四個方法中邏輯最嚴謹的。
var url = location.search;
var Request = new Object();
if (url.indexOf("?") != -1) {
var str = url.substr(1); //去掉?號
strs = str.toLowerCase();
strs = strs.split("&");
for (var i = 0; i < strs.length; i++) {
Request[strs[i].split("=")[0]] = unescape(strs[i].split("=")[1]);
}
}
var mapWidth = Request["w"];
var mapHeight = Request["h"];
這個寫法一次把所有參數解析成物件,後續取值方便。但 toLowerCase() 會把值也一起轉小寫,若參數值有意義的大小寫差異就會出錯。另外 unescape 已於多年前被標記為不建議使用,應改用 decodeURIComponent。
這些都是手刻 URL 解析的產物。最大的共同缺陷是:沒有處理 URL 編碼、沒有處理值中含有 = 或 & 的情況、也沒有考慮 hash 在查詢字串之後的混亂。
而這件事瀏覽器早就內建了。現代寫法只需一行:
const params = new URLSearchParams(location.search);
const id = params.get('id'); // 取不到時回傳 null
const width = params.get('w');
const hasKey = params.has('id');
// 支援重複參數,例如 ?tag=a&tag=b
const tags = params.getAll('tag'); // ['a', 'b']
// 也能動態組出查詢字串
params.set('page', '2');
location.href = `?${params.toString()}`;
URLSearchParams 自動處理編碼與解碼,也能正確應對值中包含特殊字元的情況,並支援所有現代瀏覽器與 Node.js。除非你需要支援 IE11,否則沒有理由再手刻解析。
最後補充一個實務提醒:URL 中的參數會被記錄在瀏覽器歷史、伺服器 log 與 Referer 標頭中,因此切勿用查詢字串傳遞密碼、權杖或個資。這類資料應走 POST body 並以 HTTPS 傳輸。
希望本文所述對你的 JavaScript 學習有所幫助。