Node.js | URLSearchParams.getAll()

介绍

URLSearchParams.getAll() 方法返回指定 URL 查询字符串中给定关键字的全部值，以数组形式返回。该方法返回所有匹配的值，而不只是第一个。

该方法是 URLSearchParams 接口的一部分，该接口提供了处理 URL 查询字符串的方法。

语法

URLSearchParams.getAll(name);

参数

• name：一个表示要返回的值的字符串，指定要查找的关键字。

返回值

一个包含所有与指定关键字匹配的值的数组，如果没有匹配的值，返回一个空数组。

用法示例

const paramsString = 'category=books&category=programming&author=John+Doe';
const searchParams = new URLSearchParams(paramsString);

console.log(searchParams.getAll('category'));
// Output: ["books", "programming"]

console.log(searchParams.getAll('author'));
// Output: ["John Doe"]

在这个示例中，我们通过 new URLSearchParams() 创建了一个 searchParams 对象，它包含查询参数字符串中的参数。接着，我们调用 searchParams.getAll() 方法，并传递了需要检索的查询关键字 category 和 author，方法返回一个包含它们的各个值的数组。

注意事项

• name 参数被视为大小写不敏感。
• 如果指定的值不存在，则会返回一个空数组。
• 如果查询字符串不包含任何参数，则 searchParams.getAll() 返回一个空数组。

结论

URLSearchParams.getAll() 方法是解析和处理 URL 查询字符串所必需的一个强大工具。它不仅可以返回所有与指定关键字匹配的值，而且还能帮助我们处理 URL 查询字符串中的复杂数据。