This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
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
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.
| Feature | Chrome | Edge | Firefox | Internet Explorer | Opera | Safari |
|---|---|---|---|---|---|---|
| Basic support | 49 | 17 | 29 | No | 36 | ? |
| Feature | Android webview | Chrome for Android | Edge mobile | Firefox for Android | Opera Android | iOS Safari | Samsung Internet |
|---|---|---|---|---|---|---|---|
| Basic support | 49 | 49 | 17 | 29 | 36 | ? | ? |
See also
- Other URL-related interfaces:
URL,URLUtils. - Google Developers: Easy URL manipulation with URLSearchParams