URLSearchParams.get()

The get() method of the URLSearchParams interface returns the first value associated to the given search parameter.

Note: This feature is available in Web Workers.

Syntax

URLSearchParams.get(name)

Parameters

name
The name of the parameter to return.

Return value

A USVString if the given search parameter is found; otherwise, null.

Examples

If the URL of your page is https://example.com/?name=Jonathan&age=18 you could parse out the 'name' and 'age' parameters using:

let params = new URLSearchParams(document.location.search.substring(1));
let name = params.get("name"); // is the string "Jonathan"
let age = parseInt(params.get("age"), 10); // is the number 18

Requesting a parameter that isn't present in the query string will return null:

let address = params.get("address"); // null

Specifications

Specification Status Comment
URL
The definition of 'get()' in that specification.
Living Standard Initial definition.

Browser compatibility

DesktopMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidFirefox for AndroidOpera for AndroidSafari on iOSSamsung Internet
getChrome Full support 49Edge Full support 17Firefox Full support 29IE No support NoOpera Full support 36Safari Full support YesWebView Android Full support 49Chrome Android Full support 49Firefox Android Full support 29Opera Android Full support 36Safari iOS Full support YesSamsung Internet Android Full support 5.0

Legend

Full support
Full support
No support
No support