SuperAPI AI 工具集

tanstack-start

前端与建站

查看项目

更新于 10-16 02:35

技能介绍

TanStack Start 是面向 SSR 的框架,本技能聚焦其服务端能力。

用途:在 React 应用中编写服务端函数、REST 风格 API 路由与中间件链,区分服务端/客户端专用代码,并处理鉴权与错误返回。

主要能力:

  • Server Functions:用 createServerFn 声明,GET 用于读取,POST 用于创建/更新/删除;POST 必须用 .inputValidator(schema) 校验输入(示例用 Zod)。
  • 鉴权:在函数内从 request.headers 获取 session;无 session 返回 AUTH_REQUIRED,权限不符返回 FORBIDDEN。
  • API 路由:在 routes/api/*.ts 中用 createFileRoute 定义 GET/POST 等处理器,返回 Response.json,校验失败返回 400 VALIDATION_ERROR,创建成功返回 201。
  • 中间件:用 createMiddleware().server() 校验会话并向下传递 context.user。
  • 环境函数:createIsomorphicFn(按端执行不同代码)、createServerOnlyFn(客户端调用抛错)、createClientOnlyFn(服务端调用抛错)。
  • 错误约定:返回 { data } 或 { error, code },常见错误码包括 AUTH_REQUIRED(401)、FORBIDDEN(403)、NOT_FOUND(404)、VALIDATION_ERROR(400)、CONFLICT(409)、INTERNAL_ERROR(500)。
  • 建议模式:始终校验输入、用 POST 做变更、记录 console.error、捕获数据库异常并返回友好信息,不泄露原始数据库错误或敏感数据。

使用方式:从 @tanstack/react-start 导入相关 API,在路由文件中定义处理器,并配合鉴权与数据库模块使用。

限制:资料仅提供上述模式与示例,未提供安装命令、版本要求、价格或具体部署方式,这些暂未提供。