URLSearchParams
接口定义了一些用于处理 URL 的查询字符串的方法。这个接口提供了一个简单的方式来读取和写入 URL 的查询字符串。以下是一些 URLSearchParams
接口中常用的方法:
-
append(name, value)
- 向 URL 的查询参数中添加一个新的查询参数,如果已存在同名的查询参数,则不会覆盖它,而是添加一个新的值(对于同一个键可以有多个值)。
-
delete(name)
- 从 URL 的查询字符串中删除指定的查询参数及其对应的值。
-
entries()
- 返回一个迭代器,遍历 URL 中所有的键值对。每个成员都是一个包含两个元素的数组,第一个元素是键名(name),第二个元素是键值(value)。
-
forEach(callback[, thisArg])
- 对 URL 中的每个键值对执行一次提供的函数。
-
get(name)
- 根据指定的键名获取查询参数的值。如果查询字符串中有多个同名的参数,则返回第一个找到的值。
-
getAll(name)
- 返回一个数组,包含查询字符串中所有指定键名的值。如果查询字符串中没有该键名,则返回一个空数组。
-
has(name)
- 返回一个布尔值,表示查询字符串中是否存在指定的键名。
-
keys()
- 返回一个迭代器,遍历 URL 中所有的键名(name)。
-
set(name, value)
- 设置查询字符串中指定键名的值。如果已存在同名的查询参数,则会覆盖它。
-
sort()
- 对查询参数进行排序,并返回一个新的
URLSearchParams
对象。注意,这个方法在原始URLSearchParams
对象上不会生效,因为它返回的是一个新的实例。
- 对查询参数进行排序,并返回一个新的
-
toString()
- 返回查询字符串的字符串表示形式,即
?
后面的部分。如果查询字符串为空,则返回空字符串。
- 返回查询字符串的字符串表示形式,即
-
values()
- 返回一个迭代器,遍历 URL 中所有的键值(value)。
URLSearchParams
是一个非常有用的接口,特别是在处理 URL 的查询字符串时,它提供了比传统字符串操作更直观、更强大的方法。