本文首发集体网站，永恒地址：https://tie.pub/2019/05/easy-...，欢送订阅。

URLSearchParams API 提供一致性接口和 URL 片段，并用于查问字符串的操作(即地址"?"之后的局部)。

在以前，开发人员应用正则表达式和字符串宰割来获取 URL 的查问参数。如果咱们始终诚恳地这样做，那就没什么意思。
那会很无趣而且经常随同着谬误。我的一个黑魔法是，我在多个大型 Google.com 利用中重用雷同的 get|set|removeURLParameter 帮忙办法，其中蕴含 Google Santa Tracker 和 Google I/O 2015 web

当初有一个更好的 API 来做这些！

URLSearchParams API

尝试演示

Chrome 49 中的 URLSearchParams 是通过 URL 标准 来实现，用来解决 URL 查问参数的 API。
我认为 URLSearchParams 对于 URls 就如同 FormData 对于 forms。

如此你会应用它吗？给你一个 URL 字符串，你能够轻松取出参数值：

// Can also constructor from another URLSearchParamsconst params = new URLSearchParams('q=search+string&version=1&person=Eric');params.get('q') === 'search string';params.get('version') === '1';Array.from(params).length === 3;
如果一个参数有多个值，get 办法只会返回第一个值。迭代参数：
for (let p of params) {  console.log(p);}

应用 set 设置一个新参数值：

params.set('version', 2);
如果一个参数有多个值，这样会删除具备雷同参数名的所有其余参数。

应用 append 为已存在的参数增加新值：

params.append('person', 'Tim');params.getAll('person') === ['Eric', 'Tim'];

应用 delete 删除一个参数：

params.delete('person');params.getAll('person') === [];
在这个例子中，将删除 URL 所有以 person 为名的查问值，而不仅仅是第一个。

与 URL 一起应用

在大多数的工夫里，咱们可能应用残缺的 URL 地址和批改利用的 URL 参数。 URL 构造方法能够不便地应用：

const url = new URL('https://example.com?foo=1&bar=2');const params = new URLSearchParams(url.search);params.set('baz', 3);params.has('baz') === true;params.toString() === 'foo=1&bar=2&baz=3';

要批改 URL 地址，你能够获取参数，更新它们地值，而后应用 history.replaceState 来更新 URL。

// URL: https://example.com?version=1.0const params = new URLSearchParams(location.search);params.set('version', 2.0);window.history.replaceState({}, '', `${location.pathname}?${params}`);// URL: https://example.com?version=2.0

在这里我应用了 ES6 的模版字符串从新更新利用的 URL 地址。

在其它中央集成 URL 应用

默认状况下，在 fetch() API 申请体中应用 FormData。如果你须要，URLSearchParams 提供一个 POST 数据替代品。

const params = new URLSearchParams();params.append('api_key', '1234567890');fetch('https://example.com/api', {  method: 'POST',  body: params}).then(...)

尽管 Chrome 还没有实现它，URLSearchParams 仍然能够与 URL 构造方法集成和 a 标签一起应用。二者都提供一个只读属性 .searchParams 查问参数的反对：

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

链接一样提供 .searchParams 属性：

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

性能检测和浏览器反对

以后，Chrome 49，Firefox 44， Opera 36 反对 URLSearchParams。

if ('URLSearchParams' in window) {  // Browser supports URLSearchParams}

为了在不反对的浏览器中应用它，举荐应用 https://github.com/ungap/url-search-params。

演示

尝试示例！

想要查看 URLSearchParams 在实在利用中的应用，请查看 Polymer's material design Iconset Generator。
我用它初始化深层链接的状态。

举荐浏览

  • 箭头函数与惯例函数的 5 个不同
  • 工夫切片（Time Slicing）