查询字符串

[稳定版: 2 - 稳定版]

node:querystring 模块提供用于解析和格式化 URL 查询字符串的实用工具。可以使用以下方法访问它：

const querystring = require('node:querystring')

querystring 的性能优于 <URLSearchParams>，但它不是标准化的 API。当性能不是关键因素或需要与浏览器代码兼容时，请使用 <URLSearchParams>。

`querystring.decode()`

添加于: v0.1.99

querystring.decode() 函数是 querystring.parse() 的别名。

`querystring.encode()`

添加于: v0.1.99

querystring.encode() 函数是 querystring.stringify() 的别名。

`querystring.escape(str)`

添加于: v0.1.25

str <字符串>

querystring.escape() 方法对给定的 str 执行 URL 百分比编码，这种编码方式针对 URL 查询字符串的特定要求进行了优化。

querystring.escape() 方法由 querystring.stringify() 使用，通常不需要直接使用。导出它的主要目的是允许应用程序代码在必要时通过将 querystring.escape 赋值给替代函数来提供替代的百分比编码实现。

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

[历史]

版本	变更
v8.0.0	现在可以正确解析多个空条目（例如 `&=&=`）。
v6.0.0	返回的对象不再继承自 `Object.prototype`。
v6.0.0, v4.2.4	`eq` 参数现在可以长度超过 `1`。
v0.1.25	新增于：v0.1.25

str <字符串> 要解析的 URL 查询字符串
sep <字符串> 用于分隔查询字符串中键值对的子字符串。默认：'&'。
eq <字符串> 用于分隔查询字符串中键和值的子字符串。默认：'='。
options <对象>
- decodeURIComponent <函数> 用于解码查询字符串中百分比编码字符的函数。默认：querystring.unescape()。
- maxKeys <数字> 指定要解析的键的最大数量。指定 0 可移除键计数限制。默认：1000。

querystring.parse() 方法将 URL 查询字符串 (str) 解析为键值对集合。

例如，查询字符串 'foo=bar&abc=xyz&abc=123' 将被解析为：

json

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

querystring.parse() 方法返回的对象不从 JavaScript Object 原型继承。这意味着诸如 obj.toString()、obj.hasOwnProperty() 等典型的 Object 方法未定义且将无法工作。

默认情况下，查询字符串中的百分比编码字符将假定使用 UTF-8 编码。如果使用替代字符编码，则需要指定替代 decodeURIComponent 选项：

// 假设 gbkDecodeURIComponent 函数已存在...

querystring.parse('w=%D6%D0%CE%C4&foo=bar', null, null, { decodeURIComponent: gbkDecodeURIComponent })

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

新增于: v0.1.25

obj <Object> 要序列化为 URL 查询字符串的对象
sep <string> 用于分隔查询字符串中键值对的子字符串。默认值: '&'。
eq <string> 用于分隔查询字符串中键和值的子字符串。默认值: '='。
options
- encodeURIComponent <Function> 将 URL 不安全字符转换为查询字符串中百分比编码时使用的函数。默认值: querystring.escape()。

querystring.stringify() 方法通过迭代对象的“自身属性”来根据给定的 obj 生成 URL 查询字符串。

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 })

`querystring.unescape(str)`

新增于：v0.1.25

str <字符串>

querystring.unescape() 方法对给定的 str 执行 URL 百分号编码字符的解码。

querystring.unescape() 方法由 querystring.parse() 使用，通常不应直接使用。导出它的主要目的是允许应用程序代码在必要时通过将 querystring.unescape 赋值给替代函数来提供替代解码实现。

默认情况下，querystring.unescape() 方法将尝试使用 JavaScript 内置的 decodeURIComponent() 方法进行解码。如果失败，则将使用一个更安全的等效方法，该方法不会在 URL 格式错误时抛出错误。

查询字符串 ​

querystring.decode() ​

querystring.encode() ​

querystring.escape(str) ​

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

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

querystring.unescape(str) ​