Skip to content

类型安全路由

中等 约 50 分钟

你将构建什么

一个路由器,路由路径如 '/users/:id' 产生有类型的参数 { id: string },且 navigate() 只接受已知路由。

学习目标

  • 使用模板字面量类型解析路由模式
  • 将路由参数提取为有类型的对象
  • 从路由定义构建路由映射类型
  • 让 navigate() 对路由参数进行类型检查

前置要求

  • 模板字面量类型
  • 条件类型(来自项目 11)
  • 映射类型(来自项目 12)

步骤

  1. 1

    从路由模式提取参数

    编写类型 RouteParams<T>,从路径如 '/users/:id/posts/:postId' 提取参数名到 { id: string; postId: string }。使用模板字面量推断。验收:RouteParams<'/users/:id'> 为 { id: string }。

  2. 2

    定义路由对象

    创建一个将路由名映射到路径的路由对象。该对象的类型驱动所有下游类型安全。验收:路由对象通过 RouteMap 接口类型检查。

  3. 3

    为 navigate 函数添加类型

    navigate 应只接受已知路由名和匹配路由参数的参数对象。验收:navigate('user', { id: '123' }) 编译通过;navigate('user', {}) 报错。

  4. 4

    添加查询字符串类型

    扩展路由器以接受有类型的查询字符串。为每个路由定义 Query 类型,让 navigate 接受可选的 query 参数。验收:navigate('post', { id: '1' }, { page: 2 }) 类型检查通过。

  5. 5

    构建 useRoute 钩子

    编写一个钩子(或函数),返回当前路由及其有类型的参数。使用路由映射收窄返回类型。验收:在 '/users/123' 上调用 useRoute() 返回 { name: 'user', params: { id: '123' } } 且类型正确。

自己动手试试

你学到了什么

你使用模板字面量类型构建了类型安全路由 —— 与 @tanstack/router 等现代框架相同的技术。编译时路由安全捕获了一整类运行时错误。

相关资源

相关课程

查阅不认识的术语

新手友好的术语表用大白话解释编程术语——变量、函数、DOM、Promise 等等。

查看术语表

解读错误信息

用大白话解释常见错误——什么意思、为什么发生、如何修复。

查看错误

← 返回主题