有了 querystring.parse 把字串轉物件,自然也需要反向操作——把物件組回查詢字串。querystring.stringify 正是它的互逆函式。
它會把物件轉換成字串,其中多個參數以 '&' 分隔、以 '=' 賦值。這個操作與 querystring.parse() 完全相反,對照範例即可一目了然。
querystring.stringify(obj, [sep], [eq])
querystring.stringify({ foo: 'bar', baz: ['qux', 'quux'], corge: '' })
// returns
'foo=bar&baz=qux&baz=quux&corge='
querystring.stringify({foo: 'bar', baz: 'qux'}, ';', ':')
// returns
'foo:bar;baz:qux'
從第一個例子可以看到,陣列型別的值會展開成多組相同鍵的參數;第二個例子則示範了自訂分隔符與賦值符的用法。
它會遍歷物件的每個鍵,對鍵與值分別做 URL 編碼,並針對陣列值做展開處理,最後以分隔符拼接:
QueryString.stringify = QueryString.encode = function(obj, sep, eq, name) {
sep = sep || '&';
eq = eq || '=';
if (util.isNull(obj)) {
obj = undefined;
}
if (util.isObject(obj)) {
return Object.keys(obj).map(function(k) {
var ks = QueryString.escape(stringifyPrimitive(k)) + eq;
if (util.isArray(obj[k])) {
return obj[k].map(function(v) {
return ks + QueryString.escape(stringifyPrimitive(v));
}).join(sep);
} else {
return ks + QueryString.escape(stringifyPrimitive(obj[k]));
}
}).join(sep);
}
if (!name) return '';
return QueryString.escape(stringifyPrimitive(name)) + eq +
QueryString.escape(stringifyPrimitive(obj));
};
搭配 parse 使用,你就能在物件與查詢字串之間自由轉換了。