URLSearchParams.append()
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
JavaScript
Copy Code
URLSearchParams.append(name, value)
Parameters
- name
- The name of the parameter to append.
- value
- The value of the parameter to append.
Returns
Void
Example
JavaScript
Copy Code
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 |
| Feature | Android | Android Webview | Firefox Mobile (Gecko) | Firefox OS | IE Mobile | Opera Mobile | Safari Mobile | Chrome for Android |
|---|---|---|---|---|---|---|---|---|
| Basic support | No support | 49.0 | 49.0 |
See also
- Other URL-related interfaces:
URL,URLUtils. - Google Developers: Easy URL manipulation with URLSearchParams
License
© 2016 Mozilla Contributors
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-us/docs/web/api/urlsearchparams/append