先看一個範例字串:
var linkURL = 'https://localhost:8080/String/string_6.html?昵稱=小西山子&age=24#id1';
對真實的 URL,JavaScript 可以透過 location 物件讀取各個組成部分:
location.origin : https://localhost 【來源/域】
location.pathname : /project_js/.../string_6.html 【路徑】
location.host : localhost 【主機 + 埠號】
location.hostname : localhost 【主機名稱】
location.port : 【埠號】
location.search : ?name=xesam 【查詢字串】
location.hash : #age 【錨點】
location.href : 完整 URL
location.protocol : http 【協定】
提取參數主要會用到 location.search。但為了讓函式更通用,我們不綁死 location,而是直接處理傳入的字串。
先盤點幾種需要正確處理的邊界情況:
?昵稱=小西山子&age=24#id1 → {昵稱:'小西山子', age:'24'}?昵稱&age=24#id1 → {昵稱:undefined, age:'24'}(只有鍵、沒有值)?=小西山子&age=24#id1 → {age:'24'}(沒有鍵的片段要丟掉)?昵稱=小西山子=又一個&age=24&age=24#id1 → {昵稱:'小西山子=又一個', age:['24','24']}(值含等號、重複鍵轉陣列)對應的實作如下,這基本等同 Prototype 的 toQueryParams:
function toQueryParams(){
var search = this.replace(/^\s+/,'').replace(/\s+$/,'').match(/([^?#]*)(#.*)?$/);
if(!search){
return {};
}
var searchStr = search[1];
var searchHash = searchStr.split('&');
var ret = {};
for(var i = 0, len = searchHash.length; i < len; i++){
var pair = searchHash[i];
if((pair = pair.split('='))[0]){
var key = decodeURIComponent(pair.shift());
var value = pair.length > 1 ? pair.join('=') : pair[0];
if(value != undefined){
value = decodeURIComponent(value);
}
if(key in ret){
if(ret[key].constructor != Array){
ret[key] = [ret[key]];
}
ret[key].push(value);
}else{
ret[key] = value;
}
}
}
return ret;
}
console.dir(toQueryParams.call(linkURL));
這裡有兩個關鍵細節:用 = 切開後再把多餘片段拼回去,以保留值裡的等號;以及遇到重複鍵時自動升級為陣列。若不想做拼接,也可以用 substring 從第一個等號之後一次取完:
function toQueryParams(){
var search = this.replace(/^\s+/,'').replace(/\s+$/,'').match(/([^?#]*)(#.*)?$/);
if(!search){
return {};
}
var searchStr = search[1];
var searchHash = searchStr.split('&');
var ret = {};
searchHash.forEach(function(pair){
var temp = '';
if(temp = (pair.split('=',1))[0]){
var key = decodeURIComponent(temp);
var value = pair.substring(key.length + 1);
if(value != undefined){
value = decodeURIComponent(value);
}
if(key in ret){
if(ret[key].constructor != Array){
ret[key] = [ret[key]];
}
ret[key].push(value);
}else{
ret[key] = value;
}
}
});
return ret;
}
console.dir(toQueryParams.call(linkURL));
反方向的轉換稍微複雜一些。由於目標格式是查詢字串,先天上只能處理單層結構,巢狀的子物件無法表達。原理就是把 toQueryParams 倒過來做:
function toQueryPair(key, value) {
if (typeof value == 'undefined'){
return key;
}
return key + '=' + encodeURIComponent(value === null ? '' : String(value));
}
function toQueryString(obj) {
var ret = [];
for(var key in obj){
key = encodeURIComponent(key);
var values = obj[key];
if(values && values.constructor == Array){
var queryValues = [];
for (var i = 0, len = values.length, value; i < len; i++) {
value = values[i];
queryValues.push(toQueryPair(key, value));
}
ret = ret.concat(queryValues);
}else{
ret.push(toQueryPair(key, values));
}
}
return ret.join('&');
}
console.log(toQueryString({ name : 'xesam', age : 24 }));
// name=xesam&age=24
console.log(toQueryString({ name : 'xesam', age : [24,25,26] }));
// name=xesam&age=24&age=25&age=26
要注意的是,Prototype 原始碼中這段是用 Enumerable 的 inject 實作的,上面已替換成等價的普通迴圈寫法。