SuperAPI AI 工具集

start-server-core

通用与其它

查看项目

更新于 10-15 22:10

技能介绍

用途:@tanstack/start-server-core 是 TanStack Start 的服务端运行时,负责处理请求、读写请求/响应数据、管理 Cookie,并为外部会话库提供集成原语。

主要能力:createStartHandler 创建主请求处理器,按三阶段处理请求——服务端函数分发(匹配 /_serverFn 前缀)、服务端路由处理、应用 SSR。请求工具包括 getRequest、getRequestHeaders、getRequestHeader、getRequestIP、getRequestHost、getRequestUrl、getRequestProtocol;响应工具包括 setResponseHeader、setResponseHeaders、setResponseStatus、appendResponseHeader、removeResponseHeader、clearResponseHeaders 及对应读取方法。Cookie 工具包括 getCookies、getCookie、setCookie、deleteCookie。

使用方式:从 @tanstack/<framework>-start/server 导入(react、solid、vue),不可从主入口导入。工具在请求处理期间任意位置可用,无需传参。示例:createStartHandler({ handler: defaultStreamHandler }),可加 transformAssets 指向 CDN。appendResponseHeader('set-cookie', ...) 可按 Cookie 身份合并序列化 Cookie,用于桥接外部会话库。

适用场景:服务端函数、服务端路由、SSR 中读取请求信息、设置响应头与状态码、管理 Cookie,以及接入 iron-session 等外部会话库。

限制:这些工具仅限服务端,在客户端导入会导致构建错误或运行时崩溃;类型完全推断,不应强制转换或标注;必须在活动请求内读取 Cookie、请求头、URL 和环境值,不可在模块作用域捕获,否则边缘运行时可能出错或造成跨请求数据泄漏。Start 无内置会话 API,会话语义由应用和会话库负责。生产环境应使用 HttpOnly、SameSite、Path=/ 和 Secure,并测试登录、SSR、过期、登出与并发请求。