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 Status Comment
URL
The definition of 'toString() (see "stringifier")' in that specification.
Living Standard Initial definition.

Browser compatibility

BCD tables only load in the browser

See also