NodeJS的querystring模块进阶

附录：常用HTTP响应头和请求头信息对照表

1. Node简介
2. 第一个node程序
3. module（模块系统）
4. npm包管理器
5. 模块系统优先级
6. 认识http内置模块
7. url内置模块
8. path内置模块
9. fs内置模块
10. http模块服务端进阶
11. http报文浅析
12. url模块进阶
13. path模块进阶
14. querystring模块进阶
15. 了解Buffer和Stream
16. os模块
17. Buffer模块
18. Stream模块
19. http模块客户端
20. Cookie浅析

querystring模块进阶

querystring 模块提供了一些实用函数，用于解析与格式化 URL 查询字符串。 使用以下方法引入：

const querystring = require('querystring');
 

querystring.escape(str)编码

• str

对给定的 str 进行 URL 编码。

该方法是提供给 querystring.stringify() 使用的，通常不直接使用。 它之所以对外开放，是为了在需要时可以通过给 querystring.escape 赋值一个函数来重写编码的实现。

默认使用 JavaScript 内置的 encodeURIComponent() 方法来编码。

querystring.unescape(str)解码

• str

对给定的 str 进行解码。

该方法是提供给 querystring.parse() 使用的，通常不直接使用。 它之所以对外开放，是为了在需要时可以通过给 querystring.unescape 赋值一个函数来重写解码的实现。

默认使用 JavaScript 内置的 decodeURIComponent() 方法来解码。

querystring.parse(str[, sep[, eq[, options]]])

• str 要解析的 URL 查询字符串。
• sep 用于界定查询字符串中的键值对的子字符串。默认为 '&'。
• eq 用于界定查询字符串中的键与值的子字符串。默认为 '='。
• options ：
  • decodeURIComponent 解码查询字符串的字符时使用的函数。默认为 querystring.unescape()。
  • maxKeys 指定要解析的键的最大数量。默认为 1000。指定为 0 则不限制。

该方法会把一个 URL 查询字符串 str 解析成一个键值对的集合。

例子，查询字符串 'foo=bar&abc=xyz&abc=123' 被解析成：

{
  foo: 'bar',
  abc: ['xyz', '123']
}
 

该方法返回的对象不继承自 JavaScript 的 Object 类。 这意味着 Object 类的方法如 obj.toString()、obj.hasOwnProperty() 等没有被定义且无法使用。

默认情况下，查询字符串中的字符会被视为使用 UTF-8 编码。 如果使用的是其他字符编码，则需要指定 decodeURIComponent 选项，例如：

// 假设存在 gbkDecodeURIComponent 函数。
querystring.parse('w=%D6%D0%CE%C4&foo=bar', null, null,
                  { decodeURIComponent: gbkDecodeURIComponent });
 

querystring.stringify(obj[, sep[, eq[, options]]])

• obj 要序列化成 URL 查询字符串的对象。
• sep 用于界定查询字符串中的键值对的子字符串。默认为 '&'。
• eq 用于界定查询字符串中的键与值的子字符串。默认为 '='。
• options ：
  • encodeURIComponent 把对象中的字符转换成查询字符串时使用的函数。默认为 querystring.escape()。

该方法通过遍历给定的 obj 对象的自身属性，生成 URL 查询字符串。

如果 obj 对象中的属性的类型为<string> | <number> | <boolean> | <string> | <number> | <boolean>，则属性的值会被序列化。 其他类型的属性的值会被强制转换为空字符串。

例子：

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'
 

默认情况下，使用 UTF-8 进行编码。 如果需要使用其他编码，则需要指定 encodeURIComponent 选项，例如：

// 假设存在 gbkEncodeURIComponent 函数。
querystring.stringify({ w: '中文', foo: 'bar' }, null, null,
                      { encodeURIComponent: gbkEncodeURIComponent });