Node.js 中的 URLSearchParams.set()

在 Node.js 中，我们可以使用 URLSearchParams 类来处理查询字符串（也就是 URL 中的参数部分）。URLSearchParams.set() 方法是该类提供的一个方法，可以用来将一个新的键/值对添加到已有的查询字符串中。下面我们来详细介绍该方法的使用方式和注意事项。

方法签名

URLSearchParams.set(name, value)

| 参数 | 类型 | 描述 | |------|------|------| | name | string | 新增的参数名，必须为字符串类型。 | | value | string | 新增参数的值，必须为字符串类型。 |

返回值

该方法没有返回值。

使用示例

下面是一个示例代码，展示了如何使用 URLSearchParams.set() 方法添加一个新的参数到查询字符串中。

const { URLSearchParams } = require('url');

const params = new URLSearchParams({
  name: 'Alice',
  age: '20',
});

console.log(params.toString()); // 输出: "name=Alice&age=20"

params.set('gender', 'female');

console.log(params.toString()); // 输出: "name=Alice&age=20&gender=female"

如上所示，我们先通过 URLSearchParams 构造函数传入一个拥有两个参数的查询字符串，随后调用 set() 方法添加一个新的参数后，再次打印查询字符串的结果。最终输出结果包含了新增的参数。

需要注意的是，调用 set() 方法时并不会对已有的参数进行修改，它是将新的参数与旧有的参数并列添加到查询字符串中。

注意事项

• 传入的参数名和参数值必须为字符串类型。
• set() 方法不会对已有的同名参数进行修改，而是将新增的参数与旧有的参数并列添加到查询字符串中。
• URLSearchParams 对象是不可变的，因此调用任何方法都不会修改对象本身，而只是返回一个新的 URLSearchParams 对象。

这就是 Node.js 中的 URLSearchParams.set() 方法的使用方式和注意事项。如有需要，可以查阅 Node.js 官方文档获取更多信息。