NodeJS - urlSearchParams.set() 方法_Node.js 菜鸟教程

URLSearchParams 类的 NodeJS urlSearchParams.set（） 方法用于设置查询字符串的名称-值对。

URLSearchParams API 提供了一些方法，这些方法提供了读取和写入 URL 查询的访问权限。此类在全局对象上也可用。

语法

以下是 NodeJS URLSearchParams.set（） 方法的语法

 URLSearchParams.set(name, value)

参数

此方法接受两个参数。下面将对此进行描述。

name：这指定了要设置的参数的名称。
value：这指定了要设置的参数的值。

返回值

此方法返回 undefined。

例

如果我们将值传递给 NodeJS urlSearchParams.set（） 方法的 'name' 和 'value' 参数，它会将这些值设置为查询字符串的名称-值对。

在以下示例中，我们尝试将几个名称/值对设置为空查询字符串。

const url = require('node:url');

let params = new URLSearchParams('');
console.log('Query string: ' + params);
console.log('Setting name-value pairs to the query string.....');

params.set('txt', 10);
params.set('pdf', 20);
params.set('dcmnt', 30);
params.set('word', 40);

console.log("Query string: " + params.toString());

输出

在执行上述程序时，它将生成以下输出

Query string:
Setting name-value pairs to the query string.....
Query string: txt=10&pdf=20&dcmnt=30&word=40

例

如果查询字符串中有任何预先存在的名称/值对与 NodeJS set（）方法要设置的名称匹配，它将删除所有匹配的名称/值对并设置新添加的对。

在以下示例中，我们尝试添加一个名称-值对，该名称-值对与查询字符串中的现有名称-值对匹配。

const url = require('node:url');

let params = new URLSearchParams('txt=10&pdf=20&dcmnt=30&word=40');
console.log('Query string: ' + params);

console.log('Setting name-value pairs to the query string.....');

params.set('txt', 15);
console.log("Query string: " + params.toString());

输出

在执行上述程序时，它将生成以下输出

Query string: txt=10&pdf=20&dcmnt=30&word=40
Setting name-value pairs to the query string.....
Query string: txt=15&pdf=20&dcmnt=30&word=40

例

如果 set（）方法要设置的值包含特殊字符，则它们将进行百分比编码，并将设置为查询字符串。

const url = require('node:url');

let params = new URLSearchParams('txt=10&pdf=20&dcmnt=30&word=40');
console.log('Query string: ' + params);

console.log('Setting name-value pairs to the query string.....');

params.set('t`x`t', 15);		 	
console.log("Query string: " + params.toString());

输出

在执行上述程序时，它将生成以下输出

Query string: txt=10&pdf=20&dcmnt=30&word=40
Setting name-value pairs to the query string.....
Query string: txt=10&pdf=20&dcmnt=30&word=40&t%60x%60t=15

<< NodeJS - urlSearchParams.sort() 方法 NodeJS - urlSearchParams.keys() 方法 >>