URLSearchParams
接口定义了一些实用的方法来处理 URL 的查询字符串。
一个实现了 URLSearchParams
的对象可以直接用在 for...of
结构中,例如下面两行是相等的。
for (var p of mySearchParams);
for (var p of mySearchParams.entries());
var url = new URL('https://www.baidu.com/s?ie=UTF-8&wd=URLSearchParams%E8%A7%A3%E6%9E%90query%E5%8F%82%E6%95%B0');
//这里只能用?开始后面的参数,不能加上地址(后面做解释)
var searchParams = new URLSearchParams(url.search);
var id = searchParams.get('ie');
var wd = searchParams.get('wd');
URLSearchParams方法介绍:
- get 方法
获取指定搜索参数的第一个值。
- append 方法
插入一个指定的键/值对作为新的搜索参数。
- entries
返回一个
iterator
可以遍历所有键/值对的对象。
- set 方法
设置一个搜索参数的新值,假如原来有多个值将删除其他所有的值。
- delete 方法
从搜索参数列表里删除指定的搜索参数及其对应的值。
- getAll 方法
获取指定搜索参数的所有值,返回是一个数组。
- has 方法
返回
Boolean
判断是否存在此搜索参数。
- keys 方法
返回
iterator
此对象包含了键/值对的所有键名。
- values 方法
返回
iterator
此对象包含了键/值对的所有值。
- sort 方法
按键名排序。
- toString 方法
返回搜索参数组成的字符串,可直接使用在URL上。
示例:
var paramsString = "q=URLUtils.searchParams&topic=api"
var searchParams = new URLSearchParams(paramsString);
for (let p of searchParams) {
console.log(p);
}
searchParams.has("topic") === true; // true
searchParams.get("topic") === "api"; // true
searchParams.getAll("topic"); // ["api"]
searchParams.get("foo") === ""; // true
searchParams.append("topic", "webdev");
searchParams.toString(); // "q=URLUtils.searchParams&topic=api&topic=webdev"
searchParams.set("topic", "More webdev");
searchParams.toString(); // "q=URLUtils.searchParams&topic=More+webdev"
searchParams.delete("topic");
searchParams.toString(); // "q=URLUtils.searchParams"
更多相关信息可以查看 MDN web docs URLSearchParams