Newly available 主要ブラウザで対応済みだが、古いバージョンでは未対応の場合がある。

URLPattern

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

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

ユーティリティ

対応ブラウザ

機能 デスクトップ モバイル
Chrome
Edge
Firefox
Safari
Chrome Android
Safari iOS
URLPattern
95
95
142
26
95
26
exec

exec() は URLPattern インターフェイスのメソッドで、 URL または URL の部分オブジェクトを受け取り、 URL とパターンとの照合結果を含むオブジェクトを返します。 URL がパターンと一致しない場合は null を返します。
95
95
142
26
95
26
hash

hash は URLPattern インターフェイスの読み取り専用プロパティで、URL のフラグメント部分と照合するパターンを含む文字列です。
95
95
142
26
95
26
hasRegExpGroups

hasRegExpGroups は URLPattern インターフェイスの読み取り専用プロパティで、URLPattern 要素のいずれかが 正規表現のキャプチャグループ を含むかどうかを示す論理値です。
122
122
142
26
122
26
hostname

hostname は URLPattern インターフェイスの読み取り専用プロパティで、URL のホスト名部分と照合するパターンを含む文字列です。
95
95
142
26
95
26
password

password は URLPattern インターフェイスの読み取り専用プロパティで、URL のパスワード部分と照合するパターンを含む文字列です。
95
95
142
26
95
26
pathname

pathname は URLPattern インターフェイスの読み取り専用プロパティで、URL のパス名部分と照合するパターンを含む文字列です。
95
95
142
26
95
26
port

port は URLPattern インターフェイスの読み取り専用プロパティで、URL のポート番号部分と照合するパターンを含む文字列です。
95
95
142
26
95
26
protocol

protocol は URLPattern インターフェイスの読み取り専用プロパティで、URL のプロトコル部分と照合するパターンを含む文字列です。
95
95
142
26
95
26
test

exec() は URLPattern インターフェイスのメソッドで、 URL または URL の部分オブジェクトを受け取り、指定された入力が現在のパターンと一致するかどうかを示す論理値を返します。
95
95
142
26
95
26
URLPattern

URLPattern() コンストラクターは、このパターンと照合する URL を表す新しい URLPattern オブジェクトを返します。
95
95
142
26
95
26
URLPattern (ignoreCase option)

`ignoreCase` オプション
107
107
142
26
107
26
username

username は URLPattern インターフェイスの読み取り専用プロパティで、URL のユーザー名部分と照合するパターンを含む文字列です。
95
95
142
26
95
26
1+対応 (バージョン) 未対応 ※注釈あり サブ機能の解説は MDN Web Docs (CC BY-SA 2.5)

実務での使いどころ

  • URLPattern の活用

    URLPattern は URL パターン API のインターフェイスで、URL または URL の一部をパターンと照合します。

注意点

  • 古いブラウザでは対応していない場合がある。

実装メモ

  • 一部の API はセキュアコンテキスト (HTTPS) やユーザー操作起点を必要とする。利用前に要件を確認すること。

参考リンク