W3cubDocs

/Web APIs

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.

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

Browser compatibility

Desktop Mobile
Chrome Edge Firefox Opera Safari Chrome Android Firefox for Android Opera Android Safari on IOS Samsung Internet WebView Android WebView on iOS
search 95 95 142 81 26 95 142 67 26 17.0 95 26

© 2005–2025 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/URLPattern/search