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.slice(1));
//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 | Status | Comment |
---|---|---|
URLThe definition of 'toString() (see "stringifier")' 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.
Update compatibility data on GitHub
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
toString
|
Chrome
Full support 49 |
Edge
Full support 17 |
Firefox
Full support 29 |
IE
No support No |
Opera
Full support 36 |
Safari
Full support Yes |
WebView Android
Full support 49 |
Chrome Android
Full support 49 |
Firefox Android
Full support 29 |
Opera Android
Full support 36 |
Safari iOS
Full support Yes |
Samsung Internet Android
Full support 5.0 |
Legend
- Full support
- Full support
- No support
- No support
See also
- The
URL
interface. - Google Developers: Easy URL manipulation with URLSearchParams
URLSearchParams.toString() by Mozilla Contributors is licensed under CC-BY-SA 2.5.