The append()
method of the URLSearchParams
interface appends a specified key/value pair as a new search parameter.
As shown in the example below, if the same key is appended multiple times it will appear in the parameter string multiple times for each value.
Note: This feature is available in Web Workers.
Syntax
URLSearchParams.append(name, value)
Parameters
- name
- The name of the parameter to append.
- value
- The value of the parameter to append.
Return value
Void.
Examples
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.
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
append | Chrome Full support 49 | Edge Full support 17 | Firefox Full support 29 | IE No support No | Opera Full support 36 | Safari Full support 10.1 | WebView Android Full support 49 | Chrome Android Full support 49 | Firefox Android Full support 29 | Opera Android Full support 36 | Safari iOS Full support 10.3 | Samsung Internet Android Full support 5.0 |
Legend
- Full support
- Full support
- No support
- No support
See also
- Other URL-related interfaces:
URL
,HTMLHyperlinkElementUtils
. - Google Developers: Easy URL manipulation with URLSearchParams