- 示例：
```
var objectParams = new URLSearchParams([ ['user1', 'abc1'], ['query2', 'first2'], ['query3', 'second3'] ]);
var objectParams1 = new URLSearchParams({"fod" : 1 , "bard" : 2});
var objectParams2 = new URLSearchParams('?fod=1&bard=2');
var urlObject = new URL('https://developer.mozilla.org/?fod=1&bard=2');
var params = new URLSearchParams(urlObject .search);
```
### append
append\(name: string, value: string\): void
将新的键值对插入到查询字符串。
- 参数：
参数名
类型
必填
说明
name
string
是
需要插入搜索参数的键名。
value
string
是
需要插入搜索参数的值。
- 示例：
```
let urlObject = new URL('https://developer.exampleUrl/?fod=1&bard=2');
let paramsObject = new URLSearchParams(urlObject.search.slice(1));
paramsObject.append('fod', 3);
```
### delete
delete\(name: string\): void
删除指定名称的键值对。
- 参数：
参数名
类型
必填
说明
name
string
是
需要删除的键值名称。
- 示例：
```
let urlObject = new URL('https://developer.exampleUrl/?fod=1&bard=2');
let paramsobject = new URLSearchParams(urlObject.search.slice(1));
paramsobject.delete('foo');
```
### getAll
getAll\(name: string\): string\[\]
获取指定名称的所有键值对。
- 参数：
参数名
类型
必填
说明
name
string
是
指定的键值名称。
- 返回值：
类型
说明
string[]
返回指定名称的所有键值对。
- 示例：
```
let urlObject = new URL('https://developer.exampleUrl/?fod=1&bard=2');
let paramsObject = new URLSearchParams(urlObject.search.slice(1));
paramsObject.append('fod', 3); // Add a second value for the foo parameter.
console.log(params.getAll('fod')) // Output ["1","3"].
```
### entries
entries\(\): IterableIterator<\[string, string\]\>
返回一个ES6的迭代器，迭代器的每一项都是一个 JavaScript Array。Array的第一项是name，Array的第二项是value。
- 返回值：
类型
说明
IterableIterator<[string, string]>
返回一个ES6的迭代器。
- 示例：
```
var searchParamsObject = new URLSearchParams("keyName1=valueName1&keyName2=valueName2");
for (var pair of searchParamsObject .entries()) { // Show keyName/valueName pairs
console.log(pair[0]+ ', '+ pair[1]);
}
```
### forEach
forEach\(callbackfn: \(value: string, key: string, parent: this\) =\> void\): void
通过回调函数来遍历URLSearchParams实例对象上的键值对。
- 参数：
- 示例：
```
var paramsOject = new URLSearchParams(document.location.search.substring(1));
var name = paramsOject.get("name"); // is the string "Jonathan"
var age = parseInt(paramsOject.get("age"), 10); // is the number 18
var address = paramsOject.get("address"); // null
```
### has
has\(name: string\): boolean
判断一个指定的键名对应的值是否存在。
- 参数：
参数名
类型
必填
说明
name
string
是
要查找的参数的键名。
- 返回值：
类型
说明
boolean
是否存在相对应的key值，存在返回true，否则返回false。
- 示例：
```
let urlObject = new URL('https://developer.exampleUrl/?fod=1&bard=2');
let paramsObject = new URLSearchParams(urlObject.search.slice(1));
paramsObject.has('bard') === true;
```
### set
set\(name: string, value: string\): void
将与name关联的URLSearchParams对象中的值设置为value。如果存在名称为name的键值对，请将第一个键值对的值设置为value并删除所有其他值。如果不是，则将键值对附加到查询字符串。
- 参数：
参数名
类型
必填
说明
name
string
是
将要设置的参数的键值名。
value
string
是
所要设置的参数值。
- 示例：
```
let urlObject = new URL('https://developer.exampleUrl/?fod=1&bard=2');
let paramsObject = new URLSearchParams(urlObject.search.slice(1));
paramsObject.set('baz', 3); // Add a third parameter.
```
### sort
sort\(\): void
对包含在此对象中的所有键值对进行排序，并返回undefined。排序顺序是根据键的Unicode代码点。该方法使用稳定的排序算法 （即，将保留具有相等键的键值对之间的相对顺序）。
- 示例：
```
var searchParamsObject = new URLSearchParams("c=3&a=9&b=4&d=2"); // Create a test URLSearchParams object
searchParamsObject.sort(); // Sort the key/value pairs
console.log(searchParamsObject.toString()); // Display the sorted query string // Output a=9&b=2&c=3&d=4
```
### keys
keys\(\): IterableIterator
返回一个所有键值对的name的ES6迭代器。
- 返回值：
类型
说明
IterableIterator<string>
返回一个所有键值对的name的ES6迭代器。
- 示例：
```
var searchParamsObject = new URLSearchParams("key1=value1&key2=value2"); // Create a URLSearchParamsObject object for testing
for (var key of searchParamsObject .keys()) { // Output key-value pairs
console.log(key);
}
```
### values
values\(\): IterableIterator
返回一个所有键值对的value的ES6迭代器。
- 返回值：
类型
说明
IterableIterator<string>
返回一个所有键值对的value的ES6迭代器。
- 示例
```
var searchParams = new URLSearchParams("key1=value1&key2=value2"); // Create a URLSearchParamsObject object for testing
for (var value of searchParams.values()) {
console.log(value);
}
```
### \[Symbol.iterator\]
\[Symbol.iterator\]\(\): IterableIterator<\[string, string\]\>
返回一个ES6的迭代器，迭代器的每一项都是一个 JavaScript Array。Array的第一项是name，Array的第二项是value。
- 返回值：
类型
说明
IterableIterator<[string, string]>
返回一个ES6的迭代器。
- 示例：
```
const paramsObject = new URLSearchParams('fod=bay&edg=bap');
for (const [name, value] of paramsObject) {
console.log(name, value);
}
```
### tostring
toString\(\): string
返回序列化为字符串的搜索参数，必要时对字符进行百分比编码。
- 返回值：
类型
说明
string
返回序列化为字符串的搜索参数，必要时对字符进行百分比编码。
- 示例：
```
let url = new URL('https://developer.exampleUrl/?fod=1&bard=2');
let params = new URLSearchParams(url.search.slice(1));
params.append('fod', 3);
console.log(params.toString());
```
## URL
### 属性
- 示例：
```
var mm = 'http://username:password@host:8080';
var a = new URL("/", mm); // Output 'http://username:password@host:8080/';
var b = new URL(mm); // Output 'http://username:password@host:8080/';
new URL('path/path1', b); // Output 'http://username:password@host:8080/path/path1';
var c = new URL('/path/path1', b); // Output 'http://username:password@host:8080/path/path1';
new URL('/path/path1', c); // Output 'http://username:password@host:8080/path/path1';
new URL('/path/path1', a); // Output 'http://username:password@host:8080/path/path1';
new URL('/path/path1', "https://www.exampleUrl/fr-FR/toto"); // Output https://www.exampleUrl/path/path1
new URL('/path/path1', ''); // Raises a TypeError exception as '' is not a valid URL
new URL('/path/path1'); // Raises a TypeError exception as '/path/path1' is not a valid URL
new URL('http://www.shanxi.com', ); // Output http://www.shanxi.com/
new URL('http://www.shanxi.com', b); // Output http://www.shanxi.com/
```
### tostring
toString\(\): string
将解析过后的URL转化为字符串。
- 返回值：