Query String
本节为你介绍Node.js Query Strings。
稳定性: 3 - 稳定
该Node.js模块提供了一些处理query strings的工具,你可以通过以下方式访问它:
const querystring = require('querystring');
Node.js Query Strings包含的方法如下:
querystring.stringify(obj[, sep][, eq][, options])
该方法可以将一个对象序列化化为一个query string 。
可以选择重写默认的分隔符('&') 和分配符 ('=')。
Options对象可能包含encodeURIComponent属性 (默认:querystring.escape),如果需要,它可以用non-utf8编码字符串。
例子:
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'
// Suppose gbkEncodeURIComponent function already exists,
// it can encode string with `gbk` encoding
querystring.stringify({ w: '中文', foo: 'bar' }, null, null,
{ encodeURIComponent: gbkEncodeURIComponent })
// returns
'w=%D6%D0%CE%C4&foo=bar'
querystring.parse(str[, sep][, eq][, options])
该方法可以将query string反序列化为对象。
你可以选择重写默认的分隔符('&') 和分配符 ('=')。
Options对象可能包含maxKeys属性(默认:1000),用来限制处理过的健值(keys)。设置为0的话,可以去掉键值的数量限制。
Options 对象可能包含decodeURIComponent属性(默认:querystring.unescape),如果需要,可以用来解码non-utf8编码的字符串。
例子:
querystring.parse('foo=bar&baz=qux&baz=quux&corge')
// returns
{ foo: 'bar', baz: ['qux', 'quux'], corge: '' }
// Suppose gbkDecodeURIComponent function already exists,
// it can decode `gbk` encoding string
querystring.parse('w=%D6%D0%CE%C4&foo=bar', null, null,
{ decodeURIComponent: gbkDecodeURIComponent })
// returns
{ w: '中文', foo: 'bar' }
querystring.escape
escape函数供querystring.stringify使用,必要时,可以重写。
querystring.unescape
unescape函数供querystring.parse使用。必要时,可以重写。
首先会尝试用decodeURIComponent,如果失败,会回退,不会抛出格式不正确的URLs。