URLSearchParams

这是一个实验中的功能
此功能某些浏览器尚在开发中,请参考浏览器兼容性表格以得到在不同浏览器中适合使用的前缀。由于该功能对应的标准文档可能被重新修订,所以在未来版本的浏览器中该功能的语法和行为可能随之改变。

URLSearchParams 接口定义了很多个用来处理 URL 参数串的方法。

构造函数

URLSearchParams(optional DOMString init="")
从一个参数串构造出 URLSearchParams 对象。
URLSearchParams(URLSearchParams init)
复制一个 URLSearchParams 对象。

方法

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

代码示例

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

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.delete("topic");
searchParams.toString(); // "q=URLUtils.searchParams"

规范

Specification Status Comment
URL
URLSearchParams
Living Standard Initial definition

浏览器兼容性

Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari
Basic support 未实现 29.0 (29.0) 未实现 未实现 未实现
Feature Android Chrome for Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Basic support 未实现 未实现 29.0 (29.0) 未实现 未实现 未实现

相关链接










 
 
 
 
 
 
 
 

文档标签和贡献者

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