URLSearchParams: append() method
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
js
append(name, value)
Parameters
name
-
The name of the parameter to append.
value
-
The value of the parameter to append.
Return value
None (undefined
).
Examples
js
let url = new URL("https://example.com?foo=1&bar=2");
let params = new URLSearchParams(url.search);
//Add a second foo parameter.
params.append("foo", 4);
//Query string is now: 'foo=1&bar=2&foo=4'
Specifications
Specification |
---|
URL Standard # dom-urlsearchparams-append |
Browser compatibility
BCD tables only load in the browser