new URLSearchParams( )用法说明

时间:2025-02-07 07:45:10

URLSearchParams 接口定义了一些实用的方法来处理 URL 的查询字符串。

方法:

该接口不继承任何属性。

()

 插入一个指定的键/值对作为新的搜索参数。

()

 从搜索参数列表里删除指定的搜索参数及其对应的值。

()

 返回一个iterator可以遍历所有键/值对的对象。

()

 获取指定搜索参数的第一个值。

()

 获取指定搜索参数的所有值,返回是一个数组。

()

 返回 Boolean 判断是否存在此搜索参数。

()

返回iterator 此对象包含了键/值对的所有键名。

()

 设置一个搜索参数的新值,假如原来有多个值将删除其他所有的值。

()

 按键名排序。

()

 返回搜索参数组成的字符串,可直接使用在URL上。

()

 返回iterator 此对象包含了键/值对的所有值。

示例

var paramsString = "q=&topic=api"
var searchParams = new URLSearchParams(paramsString);

for (let p of searchParams) {
  (p); // [q, ]、[topic, api]
}

("topic") === true; // true
("topic") === "api"; // true
("topic"); // ["api"]
("foo") === ""; // true
("topic", "webdev");
(); // "q=&topic=api&topic=webdev"
("topic", "More webdev");
(); // "q=&topic=More+webdev"
("topic");
(); // "q="