location: search property

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

Modern browsers provide URLSearchParams and URL.searchParams to make it easy to parse out the parameters from the querystring.

Value

A string.

Examples

js

// Let an <a id="myAnchor" href="/en-US/docs/Location.search?q=123"> element be in the document
const anchor = document.getElementById("myAnchor");
const queryString = anchor.search; // Returns:'?q=123'

// Further parsing:
const params = new URLSearchParams(queryString);
const q = parseInt(params.get("q")); // is the number 123

Specifications

Specification
HTML Standard
# dom-location-search-dev

Browser compatibility

BCD tables only load in the browser