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

一个实现了 URLSearchParams 的对象可以直接用在 for...of 结构中,不需要使用 entries()for (var p of mySearchParams) 就等于
for (var p of mySearchParams.entries())。

构造函数

URLSearchParams()
返回一个 URLSearchParams 对象。

属性

该接口不继承任何属性。

方法

 此接口不继承任何方法。
URLSearchParams.append()
 插入一个指定的键/值对作为新的搜索参数。
URLSearchParams.delete()
 从搜索参数列表里删除指定的搜索参数及其对应的值。
URLSearchParams.entries()
 返回一个iterator可以遍历所有键/值对的对象。
URLSearchParams.get()
 获取指定搜索参数的第一个值。
URLSearchParams.getAll()
 获取指定搜索参数的所有值,返回是一个数组。
URLSearchParams.has()
 返回 Boolean 判断是否存在此搜索参数。
URLSearchParams.keys()
返回iterator 此对象包含了键/值对的所有键名。
URLSearchParams.set()
 设置一个搜索参数的新值,假如原来有多个值将删除其他所有的值。
URLSearchParams.sort()
 按键名排序。
URLSearchParams.toString()
 返回搜索参数组成的字符串,可直接使用在URL上。
URLSearchParams.values()
 返回iterator 此对象包含了键/值对的所有值。

代码示例

var paramsString = "q=URLUtils.searchParams&topic=api"
var searchParams = new URLSearchParams(paramsString);
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"

规范

Specification Status Comment
URL
URLSearchParams
Living Standard 初次定义

浏览器兼容性

Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari Edge
Basic support 49 29.0 (29.0) 未实现 46 10.1 未实现
entries()keys()values(), and support of for...of 49 44.0 (44.0) 未实现 46 ? 未实现
USVString for constructor init object (Yes) 53.0 (53.0) 未实现 (Yes) ? 未实现
Record for constructor init object 未实现 54.0 (54.0) 未实现 ? ? 未实现
Feature Android Chrome for Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Basic support 49 49 29.0 (29.0) 未实现 未实现 10.3

相关链接























 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

文档标签和贡献者

 此页面的贡献者: ScottZhou, scscms, teoli, ziyunfei
 最后编辑者: ScottZhou,