This is an experimental technology
Because this technology's specification has not stabilized, check the compatibility table for usage in various browsers. Also note that the syntax and behavior of an experimental technology is subject to change in future versions of browsers as the specification changes.
The append() method of the URLSearchParams interface appends a specified key/value pair as a new search parameter.
Syntax
URLSearchParams.append(name, value)
Parameters
- name
- The name of the parameter to append.
- value
- The value of the parameter to append.
Returns
Void
Example
let url = new URL('https://example.com?foo=1&bar=2');
let params = new URLSearchParams(url.search.slice(1));
//Add a second foo parameter.
params.append('foo', 4);
//Query string is now: 'foo=1&bar=2&foo=4'
Specifications
| Specification | Status | Comment |
|---|---|---|
| URL The definition of 'append()' in that specification. |
Living Standard | Initial definition. |
Browser compatibility
| Feature | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari (WebKit) |
|---|---|---|---|---|---|
| Basic support | 49.0 | (Yes) | No support | (Yes) | ? |
| Feature | Android | Android Webview | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile | Chrome for Android |
|---|---|---|---|---|---|---|---|
| Basic support | No support | 49.0 | (Yes) | No support | (Yes) | ? | 49.0 |
See also
- Other URL-related interfaces:
URL,URLUtils. - Google Developers: Easy URL manipulation with URLSearchParams