类型安全路由
你将构建什么
一个路由器,路由路径如 '/users/:id' 产生有类型的参数 { id: string },且 navigate() 只接受已知路由。
学习目标
- 使用模板字面量类型解析路由模式
- 将路由参数提取为有类型的对象
- 从路由定义构建路由映射类型
- 让 navigate() 对路由参数进行类型检查
前置要求
- 模板字面量类型
- 条件类型(来自项目 11)
- 映射类型(来自项目 12)
步骤
- 1
从路由模式提取参数
编写类型 RouteParams<T>,从路径如 '/users/:id/posts/:postId' 提取参数名到 { id: string; postId: string }。使用模板字面量推断。验收:RouteParams<'/users/:id'> 为 { id: string }。
提示
使用 T extends
${string}:${infer Param}/${infer Rest}递归剥离参数。 - 2
定义路由对象
创建一个将路由名映射到路径的路由对象。该对象的类型驱动所有下游类型安全。验收:路由对象通过 RouteMap 接口类型检查。
提示
例如 const routes = { user: '/users/:id', post: '/posts/:id' } as const;
- 3
为 navigate 函数添加类型
navigate 应只接受已知路由名和匹配路由参数的参数对象。验收:navigate('user', { id: '123' }) 编译通过;navigate('user', {}) 报错。
提示
使用 keyof typeof routes 作为路由名,RouteParams<typeof routes[name]> 作为参数。
- 4
添加查询字符串类型
扩展路由器以接受有类型的查询字符串。为每个路由定义 Query 类型,让 navigate 接受可选的 query 参数。验收:navigate('post', { id: '1' }, { page: 2 }) 类型检查通过。
提示
添加单独的 QueryMap<RouteName> 类型并将其交叉到 navigate 签名中。
- 5
构建 useRoute 钩子
编写一个钩子(或函数),返回当前路由及其有类型的参数。使用路由映射收窄返回类型。验收:在 '/users/123' 上调用 useRoute() 返回 { name: 'user', params: { id: '123' } } 且类型正确。
提示
这是 @tanstack/router 和 Remix 类型路由背后的模式。
自己动手试试
你学到了什么
你使用模板字面量类型构建了类型安全路由 —— 与 @tanstack/router 等现代框架相同的技术。编译时路由安全捕获了一整类运行时错误。
相关资源
相关课程
- 模板字面量类型
在类型层面解析路由模式。
查阅不认识的术语
新手友好的术语表用大白话解释编程术语——变量、函数、DOM、Promise 等等。
解读错误信息
用大白话解释常见错误——什么意思、为什么发生、如何修复。