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

浏览器兼容性

另见