URL.search

The search property of the URL interface is a search string, also called a query string, that is a USVString containing a '?' followed by the parameters of the URL.

Modern browsers provide the URL.searchParams property to make it easy to parse out the parameters from the query string.

Note: This feature is available in Web Workers.

Syntax

const searchParams = object.search
url.search = newSearchParams

Value

A USVString.

Examples

const url = new URL('/docs/Web/API/URL/search?q=123');
console.log(url.search); // Logs "?q=123"

Specifications

Specification Status Comment
URL
The definition of 'URL.search' in that specification.
Living Standard Initial definition.

Browser compatibility

DesktopMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidFirefox for AndroidOpera for AndroidSafari on iOSSamsung Internet
searchChrome Full support YesEdge Full support 13Firefox Full support 53
Full support 53
No support 22 — 53
Notes
Notes pathname and search returned the wrong values so that for a URL of http://z.com/x?a=true&b=false, pathname would return "/x?a=true&b=false" and search would return "", rather than "/x" and "?a=true&b=false" respectively.
IE No support NoOpera Full support YesSafari Full support 10WebView Android Full support YesChrome Android Full support YesFirefox Android Full support 53
Full support 53
No support 22 — 53
Notes
Notes pathname and search returned the wrong values so that for a URL of http://z.com/x?a=true&b=false, pathname would return "/x?a=true&b=false" and search would return "", rather than "/x" and "?a=true&b=false" respectively.
Opera Android Full support YesSafari iOS Full support YesSamsung Internet Android Full support Yes

Legend

Full support
Full support
No support
No support
See implementation notes.
See implementation notes.

See also

  • The URL interface it belongs to.