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 |
---|---|---|
URL The 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.
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