qs

qs 是一个用于解析和字符串化查询字符串的 JavaScript 库。它提供了比原生 JavaScript 更强大和灵活的功能，可以轻松处理复杂的查询字符串，包括嵌套对象和数组。qs 库非常适合在客户端与服务器之间传输数据时使用，特别是在处理 URL 参数或发送 AJAX 请求时。

主要功能

• 字符串化：将 JavaScript 对象转换为查询字符串。
• 解析：将查询字符串解析为 JavaScript 对象。

安装

你可以通过 npm 或 yarn 来安装 qs：

npm install qs

或者

yarn add qs

基本用法

字符串化（Object to Query String）

假设你有一个对象并希望将其转换为查询字符串：

const qs = require("qs");

const obj = { foo: "bar", baz: ["qux", "quux"], corge: "" };
const queryString = qs.stringify(obj);
console.log(queryString); // "foo=bar&baz[0]=qux&baz[1]=quux&corge="

解析（Query String to Object）

如果你有一个查询字符串，并希望将其解析为一个对象：

const qs = require("qs");

const str = "foo[bar]=baz";
const obj = qs.parse(str);
console.log(obj); // { foo: { bar: 'baz' } }

高级用法

qs 提供了许多选项来定制其行为，比如允许数组格式、深度限制等。

数组格式

默认情况下，qs 会将数组序列化为带有索引的形式，但你可以通过设置选项来改变这一行为：

const qs = require("qs");

const obj = { foo: ["bar", "baz"] };
console.log(qs.stringify(obj, { arrayFormat: "indices" })); // "foo[0]=bar&foo[1]=baz"
console.log(qs.stringify(obj, { arrayFormat: "brackets" })); // "foo[]=bar&foo[]=baz"
console.log(qs.stringify(obj, { arrayFormat: "repeat" })); // "foo=bar&foo=baz"

深度限制

你可以指定一个最大嵌套深度来限制解析或字符串化的深度：

const qs = require("qs");

const obj = { a: { b: { c: { d: "e" } } } };
console.log(qs.stringify(obj, { depth: 1 })); // "a[b]=%5Bobject%20Object%5D"

qs 库因其灵活性和易用性，在处理复杂的查询字符串场景中非常有用。无论是构建 Web 应用还是 API 服务，它都能提供强大的支持。