Javascript 的 URLSearchParams 接口

  • 发布时间:2017-07-14 15:24:13
  • 作者:jason8482
  • 标签:javascript,URLSearchP

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

基本使用方法如下

var paramsString = "q=URLUtils.searchParams&topic=api"  // location.search.slice(1)
var searchParams = new URLSearchParams(paramsString);

searchParams.has('topic') // true
searchParams.get('topic') // "api"
searchParams.getAll('topic') // ["api"]

searchParams.get('foo') // null,注意Firefox返回空字符串
searchParams.set('foo', 2);
searchParams.get('foo') // 2

searchParams.append('topic', 'webdev');
searchParams.toString() // "q=URLUtils.searchParams&topic=api&foo=2&topic=webdev"

searchParams.append('foo', 3);
searchParams.getAll('foo') // [2, 3]

searchParams.delete('topic');
searchParams.toString() // "q=URLUtils.searchParams&foo=2&foo=3"


URLSearchParams 还有三个方法返回迭代器对象:keys() 遍历所有参数名values() 遍历所有参数值entries() 遍历所有参数的键值对

URLSearchParams实例可以当作POST数据发送,所有数据都会URL编码。

fetch('https://example.com/api', {
  method: 'POST',
  body: params
}).then(...)


DOM 的 a 元素节点的 searchParams 属性,就是一个 URLSearchParams 实例。

var a = document.createElement('a');
a.href = 'https://example.com?filter=api';
a.searchParams.get('filter') // "api"


URLSearchParams 还可以与 URL 接口结合使用。

var url = new URL(location);
var foo = url.searchParams.get('foo') || 'somedefault';