URLPattern - Web APIs | MDN

Toggle sidebar

Theme

OS default
Light
Dark

English (US)

Remember language Learn more

URLPattern

Baseline 2025

Newly available

Since September 2025, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.

Note: This feature is available in Web Workers.

The URLPattern interface of the URL Pattern API matches URLs or parts of URLs against a pattern. The pattern can contain capturing groups that extract parts of the matched URL.

More information about the syntax of patterns can be found on the API overview page: URL Pattern API.

Constructor

URLPattern()

Returns a new URLPattern object based on the given pattern and base URL.

Instance properties

hash Read only

A string containing a pattern to match the hash part of a URL.

hasRegExpGroups Read only

A boolean indicating whether or not any of the URLPattern components contain regular expression capturing groups.

hostname Read only

A string containing a pattern to match the hostname part of a URL.

password Read only

A string containing a pattern to match the password part of a URL.

pathname Read only

A string containing a pattern to match the pathname part of a URL.

port Read only

A string containing a pattern to match the port part of a URL.

protocol Read only

A string containing a pattern to match the protocol part of a URL.

search Read only

A string containing a pattern to match the search part of a URL.

username Read only

A string containing a pattern to match the username part of a URL.

Instance methods

exec()

Returns an object with the matched parts of the URL or null if the URL does not match.

test()

Returns true if the URL matches the given pattern, false otherwise.

Specifications

Specification

URL Pattern
# urlpattern

Browser compatibility

Enable JavaScript to view this browser compatibility table.

Help improve MDN

Was this page helpful to you?

Yes No

Learn how to contribute

This page was last modified on Jul 3, 2025 by MDN contributors.

View this page on GitHub • Report a problem with this content