在此页

• 句法
• 范例
• 规范
• 浏览器兼容性
• 相关话题

URLSearchParams() constructor creates and returns a new URLSearchParams 对象。

注意： 此特征可用于 Web 工作者 .

句法

var URLSearchParams = new URLSearchParams(init);
					

参数

init 可选

One of:

• USVString , which will be parsed from application/x-www-form-urlencoded format. A leading '?' character is ignored.
• A sequence of USVString pairs, representing names/values.
• A record of USVString 键和 USVString 值。

返回值

A URLSearchParams 对象实例。

范例

The following example shows how to create a URLSearchParams object from a URL string.

// Retrieve params via url.search, passed into ctor
var url = new URL('https://example.com?foo=1&bar=2');
var params = new URLSearchParams(url.search);
// Pass in a string literal
var params2 = new URLSearchParams("foo=1&bar=2");
var params2a = new URLSearchParams("?foo=1&bar=2");
// Pass in a sequence of pairs
var params3 = new URLSearchParams([["foo", "1"], ["bar", "2"]]);
// Pass in a record
var params4 = new URLSearchParams({"foo": "1", "bar": "2"});
					

规范

规范	状态	注释
URL The definition of 'URLSearchParams()' in that specification.	实时标准	初始定义。

浏览器兼容性

The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request. 更新 GitHub 上的兼容性数据

	桌面						移动
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome for Android	Firefox for Android	Opera for Android	Safari on iOS	Samsung Internet
URLSearchParams() 构造函数	Chrome 49	Edge 17	Firefox 29	IE 不支持 No	Opera 36	Safari 10.1	WebView Android 49	Chrome Android 49	Firefox Android 29	Opera Android 36	Safari iOS 10.3	Samsung Internet Android 5.0
USVString or sequence for init 对象	Chrome 61	Edge 17	Firefox 53	IE 不支持 No	Opera 48	Safari Yes	WebView Android 61	Chrome Android 61	Firefox Android 53	Opera Android 45	Safari iOS Yes	Samsung Internet Android 8.0

图例

完整支持

完整支持

不支持

不支持

元数据

• 最后修改： Apr 8, 2020

相关话题

1. URL API
2. URLSearchParams
3. 构造函数

   1. URLSearchParams()
4. 方法

   1. append()
   2. delete()
   3. entries()
   4. forEach()
   5. get()
   6. getAll()
   7. has()
   8. keys()
   9. set()
   10. sort()
   11. toString()
   12. values()
5. Related pages for URL API

   1. HTMLHyperlinkElementUtils
   2. URL
   3. URLUtilsReadOnly