URL 上常帶著一串參數,像是 ?foo=bar&baz=qux。想把它們變成方便操作鍵值對,就得靠 querystring.parse。
說白了,它就是把 URL 上帶的參數串轉成陣列物件,讓你能輕鬆讀取每個參數的值。
querystring.parse(str, [sep], [eq], [options])
querystring.parse('foo=bar&baz=qux&baz=quux&corge')
// returns
{ foo: 'bar', baz: ['qux', 'quux'], corge: '' }
值得注意的是:當同一個鍵(如 baz)出現多次時,其值會被收集成陣列;而沒有賦值的鍵(如 corge)則會得到空字串。
核心邏輯會先以分隔符切開字串,逐一以賦值符拆成鍵值,並對每個部分做 URL 解碼;若解碼失敗則退回使用 unescape 處理,最後把結果組進物件:
// Parse a key=val string.
QueryString.parse = QueryString.decode = function(qs, sep, eq, options) {
sep = sep || '&';
eq = eq || '=';
var obj = {};
if (!util.isString(qs) || qs.length === 0) {
return obj;
}
var regexp = /\+/g;
qs = qs.split(sep);
var maxKeys = 1000;
if (options && util.isNumber(options.maxKeys)) {
maxKeys = options.maxKeys;
}
var len = qs.length;
if (maxKeys > 0 && len > maxKeys) {
len = maxKeys;
}
for (var i = 0; i < len; ++i) {
var x = qs[i].replace(regexp, '%20'),
idx = x.indexOf(eq),
kstr, vstr, k, v;
if (idx >= 0) {
kstr = x.substr(0, idx);
vstr = x.substr(idx + 1);
} else {
kstr = x;
vstr = '';
}
// ... 解碼並組入 obj
}
return obj;
};
有了它,處理查詢參數就變得直觀又安全。