URLPattern: search property

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Note: This feature is available in Web Workers.

The search read-only property of the URLPattern interface is a string containing the pattern used to match the search part of a URL.

This is the normalized value of the search pattern passed to the constructor, an inherited value from a baseURL passed to the constructor, or the default value ("*"), which matches any search part.

Value

A string.

Examples

Basic usage

The following example creates a URLPattern object with 'q=baby' for the search part and logs the property. This pattern matches any URL for which the search part includes exactly that text.

js
const pattern = new URLPattern({
  search: "q=baby",
});
console.log(pattern.search); // "q=baby"
console.log(pattern.test("https://example.com/shoes?q=baby")); // true

Specifications

Specification
URL Pattern
# dom-urlpattern-search

Browser compatibility