URLPattern

Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.

The URLPattern interface 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

Note: This feature is available in Web Workers

Constructor

URLPattern()

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

Instance properties

hash

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

hostname

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

password

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

pathname

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

port

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

protocol

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

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

username

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
URLPattern API
# urlpattern

Browser compatibility

BCD tables only load in the browser

See also

  • A polyfill of URLPattern is available on GitHub
  • The pattern syntax used by URLPattern is similar to the syntax used by path-to-regexp