querystring模塊
querystring查詢字符串
- querystring.escape(str)
- [querystring.parse(str[, sep, eq[, options]])
- [querystring.stringify(obj[, sep, eq[, options]])
- querystring.unescape(str)
querystring.escape(str)
? 該方法是提供給querystring.stringify()使用的,通常不直接使用豁鲤,之所以對外開放,是為了在需要時(shí)可以通過querystring.escape賦值一個(gè)函數(shù)來重寫編程的實(shí)現(xiàn)
querystring.parse(str[, sep[, eq[, options]]])
-
str
要解析的URL查詢字符串 -
sep
用于界定查詢字符串中的鍵值對的子字符串。默認(rèn)為'&'
-
eq
用于界定查詢字符串中的鍵與值的子字符串。默認(rèn)為'='
。 -
options
-
decodeURIComponent
解碼查詢字符串的字符時(shí)使用的函數(shù)。默認(rèn)為querystring.unescape()
-
maxKeys
指定要解析的鍵的最大數(shù)量。指定為0
則不限制或渤。默認(rèn)為1000
。
-
該方法會(huì)把一個(gè)url查詢字符串str解析成一個(gè)鍵值對的集合
var foo=bar&abc=xyz&abc=123
querystring.parse(foo)
//輸出結(jié)果
/*
{
foo: 'bar',
abc: ['xyz', '123']
}
*/
注意:
? 該方法返回的對象不繼承自JavaScript的object類奕扣,這意味著object類的方法如obj.toString
薪鹦、obj.hasOwnProperty()
等沒有被定義且無法使用
默認(rèn)情況下,查詢字符串中的字符會(huì)被視為使用 UTF-8 編碼惯豆。 如果使用的是其他字符編碼池磁,則需要指定 decodeURIComponent
選項(xiàng),例如:
// 假設(shè)存在 gbkDecodeURIComponent 函數(shù)楷兽。
querystring.parse('w=%D6%D0%CE%C4&foo=bar', null, null,
{ decodeURIComponent: gbkDecodeURIComponent });
querystring.stringify(obj[, sep[, eq[, options]]])
-
obj
要序列化成 URL 查詢字符串的對象 -
sep
用于界定查詢字符串中的鍵值對的子字符串地熄。默認(rèn)為'&'
。 -
eq
用于界定查詢字符串中的鍵與值的子字符串芯杀。默認(rèn)為'='
端考。 -
options
-
encodeURIComponent
把對象中的字符轉(zhuǎn)換成查詢字符串時(shí)使用的函數(shù)。默認(rèn)為querystring.escape()
揭厚。該方法通過遍歷給定的obj
對象的自身屬性却特,生成 URL 查詢字符串。
-
如果 obj
對象中的屬性的類型為string,number,boolean,string[],number[],boolean[],則屬性的值會(huì)被序列化筛圆,其他類型的屬性的值會(huì)被強(qiáng)制轉(zhuǎn)換為空字符串
實(shí)例
querystring.stringify({ foo: 'bar', baz: ['qux', 'quux'], corge: '' });
// 返回 'foo=bar&baz=qux&baz=quux&corge='
querystring.stringify({ foo: 'bar', baz: 'qux' }, ';', ':');
// 返回 'foo:bar;baz:qux'
默認(rèn)情況下裂明,使用 UTF-8 進(jìn)行編碼。 如果需要使用其他編碼顽染,則需要指定 encodeURIComponent
選項(xiàng)
// 假設(shè)存在 gbkEncodeURIComponent 函數(shù)漾岳。
querystring.stringify({ w: '中文', foo: 'bar' }, null, null,
{ encodeURIComponent: gbkEncodeURIComponent });
querystring.unescape(str)
-
str
對給定的str進(jìn)行解碼?
? 該方法是提供給
querystring.parse()
使用的,通常不直接使用粉寞。 它之所以對外開放尼荆,是為了在需要時(shí)可以通過給querystring.unescape
賦值一個(gè)函數(shù)來重寫解碼的實(shí)現(xiàn)。默認(rèn)使用 JavaScript 內(nèi)置的
decodeURIComponent()
方法來解碼唧垦。?