本技能面向 Cloudflare Workers 运行时,整理 Fetch、Streams、Crypto、Cache、WebSockets 与 Encoding 六类 API 的用途与用法。Fetch 用于发起 HTTP 请求、代理外部 API;Streams 用于大文件与实时数据流;Crypto 用于哈希、签名与加密;Cache 用于响应缓存以降低延迟和 API 成本;WebSockets 用于聊天、实时更新;Encoding 处理 UTF-8 与 Base64。
关键规则:外部请求要设超时(Workers 有 30 秒限制);读取响应体前先 clone,因为 body 只能读一次;大负载用流式,避免整体缓冲;缓存外部 API 响应;Crypto 操作放 try/catch;WebSocket 配合 Durable Objects 的休眠降低成本。
常见错误与预防:body 已读(先 clone)、fetch 超时(AbortController)、无效 JSON(先检查 content-type)、stream 被锁(不要重复读取)、密钥格式错误(校验 keyData)、缓存未命中(返回前检查)、WebSocket 意外断开(处理 close 并实现重连)、编码错误(正确使用 TextEncoder/TextDecoder)、CORS 被拦截(补正确的 CORS 头)、请求过大(流式上传)。
用法按任务加载参考:HTTP 请求看 references/fetch-api.md;大数据处理看 streams-api.md;加解密看 crypto-api.md;缓存看 cache-api.md;实时功能看 websockets.md;编码看 encoding-api.md。模板包括 fetch-patterns.ts、stream-processing.ts、crypto-operations.ts、websocket-handler.ts。官方文档地址已在资料中提供。具体收费、价格与平台限制暂未提供。