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.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
URL Standard (URL) # urlsearchparams-stringification-behavior

Browser compatibility

	Desktop						Mobile
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	WebView Android	Chrome Android	Firefox for Android	Opera Android	Safari on IOS	Samsung Internet
`toString`	49	17	29	No	36	10.1	49	49	29	36	10.3	5.0