URLPattern

基準線 2025
新推出

自 ⁨2025 年 9 月⁩起,此功能適用於最新裝置和瀏覽器版本。此功能可能不適用於較舊的裝置或瀏覽器。

注意:此功能在 Web Workers 中可用。

URLPattern 介面是 URL Pattern API 的一部分,用於將 URL 或 URL 的一部分與模式進行匹配。模式可以包含捕獲組,用於提取匹配 URL 的部分。

有關模式語法的更多資訊,請參閱 API 概覽頁面:URL Pattern API

建構函式

URLPattern()

根據給定的模式和基礎 URL 返回一個新的 URLPattern 物件。

例項屬性

hash 只讀

一個用於匹配 URL 的 hash 部分的模式字串。

hasRegExpGroups 只讀

一個布林值,指示 URLPattern 的任何元件是否包含 正則表示式捕獲組

hostname 只讀

一個用於匹配 URL 的 主機名 部分的模式字串。

password 只讀

一個用於匹配 URL 的 密碼 部分的模式字串。

pathname 只讀

一個用於匹配 URL 的 路徑名 部分的模式字串。

port 只讀

一個用於匹配 URL 的 部分的模式字串。

protocol 只讀

一個用於匹配 URL 的 協議 部分的模式字串。

一個用於匹配 URL 的 搜尋 部分的模式字串。

username 只讀

一個用於匹配 URL 的 使用者名稱 部分的模式字串。

例項方法

exec()

返回一個包含 URL 匹配部分的物件,如果 URL 不匹配則返回 null

test()

如果 URL 與給定模式匹配,則返回 true,否則返回 false

規範

規範
URL 模式
# urlpattern

瀏覽器相容性

另見