SuperAPI AI 工具集

start-core/server-routes

编程与开发

查看项目

更新于 10-16 00:00

技能介绍

用途:在 TanStack Router 应用中,把 API 端点与应用路由放在同一套基于文件的路由体系里,用 createFileRoute 的 server 属性处理原始 HTTP 请求。

主要能力:支持 GET、POST、PUT、DELETE 等 HTTP 方法处理器;同一文件可同时定义服务端路由与 UI 路由;遵循文件路由约定(如 routes/users/$id.ts 对应 /users/$id,routes/api/file/$.ts 为 splat 通配);处理器可获取 request、params、context、pathname、next;支持 request.json()、request.text()、request.formData() 解析请求体;可用 Response.json 返回 JSON,并设置状态码与响应头;支持路由级 middleware 与通过 createHandlers 为单个方法配置中间件。

使用方式:在 src/routes 下创建文件,导出 createFileRoute 定义的 Route,在 server.handlers 中编写方法处理函数;动态参数用 $ 前缀,通配用 $;中间件可写在 server.middleware 或 createHandlers 的单个处理器中。

限制与注意:每个路由只能有一个处理器文件,routes/users.ts 与 routes/users/index.ts 等会冲突;读取请求体必须 await,否则得到的是 Promise;资料未提供安装命令、版本要求或收费信息。