SuperAPI AI 工具集

start-server-core

通用与其它

查看项目

更新于 10-16 00:00

技能介绍

用途:TanStack Start 的服务端运行时,负责处理所有传入请求,并提供请求、响应、Cookie、会话与查询校验等工具。

主要能力:createStartHandler 创建主请求处理器,按三阶段处理请求——服务端函数分发(匹配 /_serverFn 前缀)、服务端路由处理、应用 SSR;可配合 defaultStreamHandler 渲染 HTML,并支持 transformAssets 做 CDN 资源地址转换。请求工具包括 getRequest、getRequestHeaders、getRequestHeader、getRequestIP、getRequestHost、getRequestUrl、getRequestProtocol;响应工具包括 setResponseHeader、setResponseHeaders、setResponseStatus、getResponseHeaders、getResponseHeader、getResponseStatus、removeResponseHeader、clearResponseHeaders;Cookie 工具包括 getCookies、getCookie、setCookie、deleteCookie;会话工具包括 useSession、getSession、updateSession、clearSession,会话数据加密存储在 Cookie 中,需提供 password 加密密钥,可配置 name、maxAge、cookie。查询校验使用 getValidatedQuery,接受 Standard Schema 校验器(非回调函数)。

使用方式:从 @tanstack/<framework>-start/server 导入(react、solid、vue 等),在 createServerFn 的 handler 内调用,无需逐层传参。

限制:这些工具仅限服务端,在客户端代码中导入会导致构建错误或运行时崩溃;类型完全推断,不应手动断言或标注;会话操作大多需要 password,缺失会在运行时抛错;生产环境会话 Cookie 应设置 secure: true。

适用场景:TanStack Start 应用的服务端函数、服务端路由、SSR 请求处理与鉴权、会话管理。

暂未提供:具体版本要求、安装命令与更多平台细节。