JavaScript URLPattern.exec 怎样用 baseURL 匹配相对路由地址
要让 URLPattern.exec() 匹配相对路由,关键是把相对路径和可解析的 baseURL 一起传入。比如模式定义为 https://*.example.com/books/:id,调用 pattern.exec('/books/123', 'https://store.example.com') 后,浏览器会先按基址解析路径,再把命名组 id 放到返回对象的 pathname.groups.id 中。
官方地址:https://developer.mozilla.org/en-US/docs/Web/API/URLPattern/exec
这篇只处理字符串形式的相对 URL、baseURL 和匹配结果,不把它扩展成完整路由器。需要记住三条:相对 URL 没有基址时不会得到可用的绝对输入;基址本身不能解析时也不会命中;模式不匹配时返回 null,不能直接读取 pathname.groups。
先理解 URLPattern.exec 的两个字符串参数
exec(url, baseURL) 的第一个参数是要匹配的 URL,可以是绝对地址,也可以是相对地址。第二个参数只在第一个参数需要解析时发挥作用,它提供协议、主机和端口等基准信息。绝对 URL 已经自带这些信息,再传第二个参数反而会让调用边界变得不清晰。
下面这张结构说明图把“相对路径 → baseURL → 可匹配绝对地址”的关系放在一起。它是静态说明图,不是浏览器截图,也不是本机运行证据。

创建带命名路径组的模式
命名组直接写在路径模式里,例如 :id。为了让示例边界清楚,下面只匹配 HTTPS 或 HTTP 的 example.com 子域,并要求路径以 /books/ 开始。
// 用命名组 id 捕获书籍编号,协议允许 http 或 https
const pattern = new URLPattern("http{s}?://*.example.com/books/:id");
// 先用完整地址匹配,便于确认模式本身没有问题
const absoluteMatch = pattern.exec("https://store.example.com/books/123");
// 命中后再读取命名组;不命中时不要直接访问 pathname
if (absoluteMatch) {
console.log(absoluteMatch.pathname.groups.id); // 123
}
返回值不是传统正则表达式那样的扁平数组,而是包含多个 URL 部件的对象。命中的路径位于 pathname,命名捕获组位于它的 groups 属性中。
用 baseURL 匹配相对路由地址
当应用只拿到当前页面下的相对路由时,把它和站点基址一起传给 exec 即可。第二个参数不是“再匹配一次的字符串”,而是用于解析第一个参数的基准 URL。
// 相对路径需要基址才能解析成完整 URL
const relativeMatch = pattern.exec(
"/books/123",
"https://store.example.com"
);
// inputs 保留原始调用形态,pathname.groups.id 保存命名组
if (relativeMatch) {
console.log(relativeMatch.inputs); // ["/books/123", "https://store.example.com"]
console.log(relativeMatch.pathname.input); // /books/123
console.log(relativeMatch.pathname.groups.id); // 123
}
这里的命中逻辑可以拆成两步理解:先把 /books/123 放到 https://store.example.com 下,得到可匹配的完整地址;再按模式中的通配子域和 :id 命名组提取结果。inputs 仍会记录原始输入,所以它与直接传完整地址时的内容不一样。
处理返回对象、null 与异常边界
工程代码中不要把“调用成功”和“匹配成功”混为一谈。exec 可能返回匹配对象,也可能返回 null。缺少基址、基址不可解析、协议不符合模式,最终都应该在调用层被当成未命中处理,而不是继续读取结果字段。
// 统一把 URLPattern 的未命中结果转换成业务可用的分支
function readBookId(pathname, baseURL) {
// 相对路径必须和 baseURL 一起传入,避免依赖隐式当前页面地址
const match = pattern.exec(pathname, baseURL);
if (!match) {
return { matched: false, reason: "url-not-matched" };
}
// 命名组值来自 pathname 部件,不从 inputs 数组猜位置
return {
matched: true,
id: match.pathname.groups.id,
};
}
console.log(readBookId("/books/123", "https://store.example.com"));
// { matched: true, id: "123" }
console.log(readBookId("/books/123", "data:text/plain,hello"));
// { matched: false, reason: "url-not-matched" }
第二次调用的基址不能形成适合该模式的 HTTP(S) 绝对 URL,因此返回 null。实际项目如果要区分“缺少 baseURL”“基址非法”和“模式不匹配”,可以在进入 exec 前先做输入分层;但不要把 null 当成含有空 groups 的对象。
下面的结果说明图集中展示了命中、未命中和缺少基址三条分支。它同样是原创静态结构图,不是运行输出截图。

字符串形式与对象形式怎样选择
如果手里是浏览器地址栏、路由表或接口返回的字符串,使用 exec(url, baseURL) 最直接。如果已经把协议、主机、路径拆成字段,使用对象形式更容易把字段来源写清楚,例如 pattern.exec({ pathname: "/books/123", baseURL: "https://store.example.com" })。
两种形式不要混用参数:对象形式已经通过 input.baseURL 表达基址,不能再额外传第二个 baseURL 参数,否则会触发 TypeError。另外,基址可以补齐 URL 左侧更具体的部分,但用户名和密码不会从基址继承;不要把它当成任意字符串拼接器。
| 场景 | 调用方式 | 结果判断 |
|---|---|---|
| 完整 URL | exec("https://store.example.com/books/123") | 直接匹配,命中后读取 pathname.groups |
| 相对路径 | exec("/books/123", "https://store.example.com") | 先解析基址,再匹配 |
| 结构化 URL 部件 | exec({ pathname, baseURL }) | 使用对象字段,不能再传第二个参数 |
| 模式不匹配或无法解析 | 保留返回值并判断 | 得到 null |
小结:把 baseURL 当解析前提
JavaScript URLPattern.exec 处理相对路由时,稳定写法是“相对路径 + 明确 baseURL + 判空后读取命名组”。模式负责定义可接受的 URL 形状,baseURL 负责让相对输入具备解析上下文,返回对象负责告诉你具体哪个 URL 部件和命名组命中了。
如果调用结果为空,优先检查三件事:相对路径是否真的传入了 baseURL,baseURL 是否能解析成目标协议,模式中的主机与 pathname 是否覆盖了最终地址。这样比直接改正则或把路径拼成字符串更容易定位问题。
相关问题
URLPattern.exec 不传 baseURL 为什么匹配不到相对路径?
相对路径缺少协议和主机,无法独立解析成完整 URL。对字符串形式调用时,应把可解析的绝对基址作为第二个参数传入。
URLPattern.exec 命中后怎样读取命名参数?
先判断返回值不为 null,再从对应 URL 部件的 groups 读取,例如路径中的 :id 对应 match.pathname.groups.id。
baseURL 可以写成 data URL 吗?
它可能能被解析为 URL,但不一定符合你的 URLPattern 协议与主机模式。应根据模式要求传入能解析且最终匹配的基址,不要只判断字符串非空。
对象形式还能再传第二个参数吗?
不能。对象形式把基址放在 input.baseURL 中;对象输入再传额外的 baseURL 会触发 TypeError。
Linux findmnt -T 怎样判断路径挂载在哪个文件系统
- 上一篇
- Linux findmnt -T 怎样判断路径挂载在哪个文件系统
- 下一篇
- JavaScript ResizeObserver 怎样避免观察回调循环
-
- 文章 · 前端 | 23小时前 | 前端 · javascript · JavaScript DOM遍历 NodeIterator referenceNode
- JavaScript NodeIterator.referenceNode 怎样读取迭代器当前参照的节点
- 326浏览 收藏
-
- 文章 · 前端 | 1天前 | 前端 · JavaScript Event defaultPrevented
- JavaScript Event.defaultPrevented 怎样判断事件默认行为是否已经被取消
- 391浏览 收藏
-
- 文章 · 前端 | 1天前 | 前端 · javascript · 浏览器API · JavaScript Selection focusNode focusOffset DOM Node 文本选择
- JavaScript Selection.focusNode 怎样取得用户当前延伸选择的端点节点
- 492浏览 收藏
-
- 文章 · 前端 | 1天前 | 前端 · javascript · JavaScript CSSOM CSSStyleSheet CSSRule parentStyleSheet cssRules parentRule
- JavaScript CSSRule.parentStyleSheet 怎样取得一条规则所属的样式表
- 323浏览 收藏
-
- 文章 · 前端 | 1天前 | javascript · JavaScript 滚动条 Element.clientLeft 左边框
- JavaScript Element.clientLeft 怎样理解左边框宽度与滚动条占位
- 290浏览 收藏
-
- 文章 · 前端 | 1天前 | 前端 · javascript · JavaScript Shadow DOM Event.composed
- JavaScript Event.composed 怎样判断事件能否跨越影子根边界
- 149浏览 收藏
-
- 文章 · 前端 | 1天前 | javascript · JavaScript dom Selection anchorOffset
- JavaScript Selection.anchorOffset 怎样理解选择起点在文本与元素中的偏移
- 496浏览 收藏
-
- 文章 · 前端 | 1天前 | javascript · JavaScript CSSStyleSheet ownerRule CSSImportRule
- JavaScript StyleSheet.ownerRule 怎样取得导入样式表对应的规则对象
- 357浏览 收藏
-
- 文章 · 前端 | 1天前 | html · 前端 · javascript · 表单 · JavaScript id for label 表单控件 Control HTMLLabelElement
- JavaScript HTMLLabelElement.control 怎样取得标签实际关联的表单控件
- 338浏览 收藏
-
- 文章 · 前端 | 1天前 | 前端 · javascript · JavaScript DOM遍历 TreeWalker NodeFilter whatToShow
- JavaScript TreeWalker.whatToShow 怎样区分节点类型掩码与自定义过滤器
- 223浏览 收藏
-
- 文章 · 前端 | 1天前 | 前端 · range · javascript · JavaScript dom range 富文本 isPointInRange 节点偏移
- JavaScript Range.isPointInRange 怎样判断指定节点偏移是否落在范围内
- 145浏览 收藏
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 543次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 516次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 500次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 485次学习
-
- PubMedQA
- 深入了解PubMedQA生物医学问答数据集,涵盖其核心功能、使用方法及在临床决策、药物研发等场景的应用,助力提升NLP模型性能。
- 1127次使用
-
- H2O EvalGPT
- H2O EvalGPT是H2O.ai推出的开源LLM评估平台,提供详细的大模型性能排行榜、行业特定基准测试及A/B测试功能,助您快速选择最适合项目的高性能大语言模型。
- 1112次使用
-
- LMArena
- LMArena是加州大学伯克利分校推出的AI模型匿名评测平台。通过盲测投票机制,用户可对比不同大模型回答并生成实时排行榜,助力开发者优化模型及用户选择最佳AI工具。
- 1287次使用
-
- HELM
- 深入了解斯坦福推出的HELM(Holistic Evaluation of Language Models)大模型评测体系。本文解析其核心功能、安装配置步骤及应用场景,涵盖准确性、公平性、鲁棒性等多维度指标,助力开发者全面优化语言模型性能。
- 1227次使用
-
- MMBench
- MMBench是由上海人工智能实验室等机构联合推出的多模态基准测试平台,提供细粒度能力评估、大规模数据集及VLMEvalKit工具。本文详细介绍其核心功能、安装使用方法及应用场景,助力开发者全面评估多模态模型性能。
- 1077次使用
-
- 接口偶发 404 怎么办:从前端路径、Nginx rewrite 到后端路由逐层定位
- 2026-06-30 166浏览
-
- Go语言对前端领域的入侵WebAssembly运行原理
- 2022-12-31 130浏览
-
- Go语言HttpRouter路由使用方法详解
- 2023-02-16 119浏览
-
- golang beego框架路由ORM增删改查完整案例
- 2022-12-30 456浏览
-
- 基于gin的golang web开发:路由示例详解
- 2023-01-07 390浏览
