登录
推荐 文章 Go 技术 课程 下载 专题 AI
首页 >  文章 >  前端

JavaScript URLPattern.exec 怎样用 baseURL 匹配相对路由地址

来源:17golang原创

时间:2026-11-19 19:50:17 283浏览 收藏

要让 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 → 可匹配绝对地址”的关系放在一起。它是静态说明图,不是浏览器截图,也不是本机运行证据。

URLPattern exec 将相对路径与 baseURL 解析为可匹配地址的结构关系
图1:结构说明图,展示相对 URL、baseURL 与 URLPattern 匹配输入的关系,不是截图或运行证据。

创建带命名路径组的模式

命名组直接写在路径模式里,例如 :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 的对象。

下面的结果说明图集中展示了命中、未命中和缺少基址三条分支。它同样是原创静态结构图,不是运行输出截图。

URLPattern exec 命中结果与 null 分支的返回结构说明
图2:结果分支说明图,展示命中对象、命名组和 null 未命中边界,不是截图或运行证据。

字符串形式与对象形式怎样选择

如果手里是浏览器地址栏、路由表或接口返回的字符串,使用 exec(url, baseURL) 最直接。如果已经把协议、主机、路径拆成字段,使用对象形式更容易把字段来源写清楚,例如 pattern.exec({ pathname: "/books/123", baseURL: "https://store.example.com" })。

两种形式不要混用参数:对象形式已经通过 input.baseURL 表达基址,不能再额外传第二个 baseURL 参数,否则会触发 TypeError。另外,基址可以补齐 URL 左侧更具体的部分,但用户名和密码不会从基址继承;不要把它当成任意字符串拼接器。

场景调用方式结果判断
完整 URLexec("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。

声明:本文转载于:17golang原创 如有侵犯,请联系study_golang@163.com删除
相关阅读
更多>
最新阅读
更多>
课程推荐
更多>