URLSearchParams.toString()
The toString()
method of the
URLSearchParams
interface returns a query string suitable for use in a
URL.
Note: This method returns the query string without the question mark. This is different from window.location.search, which includes it.
Note: This feature is available in Web Workers
Syntax
URLSearchParams.toString()
Parameters
None.
Return value
A DOMString
, without the question mark. (Returns an empty string if no
search parameters have been set.)
Examples
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);
console.log(params.toString());
//Prints 'foo=1&bar=2&foo=4'
// note: params can also be directly created
let url = new URL('https://example.com?foo=1&bar=2');
let params = url.searchParams;
// or even simpler
let params = new URLSearchParams('foo=1&bar=2');
Specifications
Specification |
---|
URL Standard # urlsearchparams-stringification-behavior |
Browser compatibility
BCD tables only load in the browser
See also
- The
URL
interface. - Google Developers: Easy URL manipulation with URLSearchParams