URL.searchParams

This is an experimental technology
Because this technology's specification has not stabilized, check the compatibility table for usage in various browsers. Also note that the syntax and behavior of an experimental technology is subject to change in future versions of browsers as the specification changes.

The searchParams property of the URL interface returns a URLSearchParams object allowing access to the GET query arguments contained in the URL.

Syntax

var urlSearchParams = URL.searchParams;

Value

URLSearchParams object.

Example

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 URL(document.location)).searchParams;
let name = params.get("name"); // is the string "Jonathan"
let age = parseInt(params.get("age")); // is the number 18

Specifications

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

Browser compatibility

Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari (WebKit)
Basic support 51.0 52.0 (52.0) ? ? ?
Feature Android Android Webview Firefox Mobile (Gecko) Firefox OS IE Mobile Opera Mobile Safari Mobile Chrome for Android
Basic support 51.0 51.0 52.0 (52.0) ? ? ? ? 51.0

Document Tags and Contributors

 Contributors to this page: goeddea, JamesGreene, bunnybooboo, Jonathan_Watt, jpmedley, nhnt11
 Last updated by: goeddea,