URLSearchParams: toString() method

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨April 2018⁩.

Note: This feature is available in Web Workers.

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 Location.search, HTMLAnchorElement.search, and URL.search, which all include the question mark.

A string, without the question mark. Returns an empty string if no search parameters have been set. Characters in the application/x-www-form-urlencoded percent-encode set (which contains all code points except ASCII alphanumeric, *, -, ., and _) are percent-encoded, and U+0020 SPACE is encoded as +.

Examples

const url = new URL("https://example.com?foo=1&bar=2");
const 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'

Specifications

This feature is defined in the following specifications:

URL
# urlsearchparams-stringification-behavior

URLSearchParams: toString() method

Syntax

Parameters

Return value

Examples

Specifications

Browser compatibility

See also

In this article