SuperAPI AI 工具集

workers-runtime-apis

部署与运维

查看项目

更新于 10-16 01:12

技能介绍

用途:整理 Cloudflare Workers 运行时 API 的使用方法,帮助开发者在 Workers 环境中完成 HTTP 请求、数据流处理、加密、缓存与实时连接等任务。

主要能力:Fetch 用于外部 API 请求与代理;Streams 用于大文件与实时数据流;Crypto 用于哈希、签名与加密;Cache 用于响应缓存与性能优化;WebSockets 用于聊天与实时更新;Encoding 用于 UTF-8 与 Base64 等文本编码。资料附有快速参考表、代码模式与模板,如 fetch-patterns.ts、stream-processing.ts、crypto-operations.ts、websocket-handler.ts。

使用方式:按任务加载对应参考资料,例如发起 HTTP 请求参考 fetch-api.md,处理大数据参考 streams-api.md,加密签名参考 crypto-api.md,缓存参考 cache-api.md,实时功能参考 websockets.md,编码参考 encoding-api.md。

关键规则:外部请求需设置超时,Workers 有 30 秒限制;读取响应体前先克隆,因响应体只能读一次;大负载使用流式处理;缓存外部 API 响应以降低延迟与成本;Crypto 操作放入 try/catch;WebSocket 可结合 Durable Objects 的休眠机制降低成本。

常见错误:响应体已被消费、请求挂起超时、无效 JSON、流被锁定、Crypto 密钥错误、缓存未命中、WebSocket 意外断开、编码错误、CORS 被拦截、请求体过大(413)。资料也给出超时与重试的 Fetch 模式示例。

适用场景:需要在 Workers 中调用外部 API、代理请求、流式传输大文件、做哈希或 HMAC 签名、缓存响应、实现实时通信与文本编码的场景。

限制:资料未说明收费、价格与平台差异;部分 API 依赖 Workers 运行时环境,代码示例需结合实际项目调整;官方文本未提供,细节以引用链接为准。