このページはコミュニティーの尽力で英語から翻訳されました。MDN Web Docs コミュニティーについてもっと知り、仲間になるにはこちらから。

View in English Always switch to English

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.

メモ: この機能はウェブワーカー内で利用可能です。

URLPatternURL パターン API のインターフェイスで、URL または URL の一部をパターンと照合します。パターンには、照合された URL の一部を抽出するキャプチャグループを含めることができます。

パターンの構文の詳細については、 API の概要ページ「URL パターン API」をご覧ください。

コンストラクター

URLPattern()

指定されたパターンとベース URL に基づいて、新しい URLPattern オブジェクトを返します。

インスタンスプロパティ

hash 読取専用

URL のハッシュ部分と照合するパターンが含まれている文字列。

hasRegExpGroups 読取専用

論理値で、この URLPattern の成分のいずれかが正規表現キャプチャグループを含んでいるかどうかを示します。

hostname 読取専用

URL のホスト名部分と照合するパターンが含まれている文字列。

password 読取専用

URL のパスワード部分と照合するパターンが含まれている文字列。

pathname 読取専用

URL のパス名部分と照合するパターンが含まれている文字列。

port 読取専用

URL のポート番号部分と照合するパターンが含まれている文字列。

protocol 読取専用

URL のプロトコル部分と照合するパターンが含まれている文字列。

URL の検索部分と照合するパターンが含まれている文字列。

username 読取専用

URL のユーザー名部分と照合するパターンが含まれている文字列。

インスタンスメソッド

exec()

URL と一致する部分を持つオブジェクトを返します。URL が一致しない場合は null を返します。

test()

URL が指定されたパターンと一致する場合は true、それ以外の場合は false を返します。

仕様書

Specification
URL Pattern
# urlpattern

ブラウザーの互換性

関連情報

  • URLPattern のポリフィルが GitHub にあります。
  • URLPattern で使用されるパターン構文は、 path-to-regexp で使用される構文と似ています。