跳转到内容
本站为社区维护的非官方中文翻译,与 Cloudflare, Inc. 无关联。本站不提供账户登录,请勿在任何非官方站点输入您的 Cloudflare 账户信息。官方文档:developers.cloudflare.com

更新日志

最后更新 查看 MarkdownAgent 设置

本更新日志记录 Cloudflare 仪表板、Wrangler、API 和 workerd 运行时中对 Workers 的重要变更。这些变更不可配置。

这与兼容性日期和兼容性标志不同——后者允许你显式选择加入或退出 Workers 运行时的特定变更。

Subscribe to RSS

2026-06-04

  • 将 v8 更新到 15.0 版本。

2026-05-13

  • 修复了一个回归问题:在 SendEmail 构建器上为 to/cc/bcc 传递数组时会产生“Invalid email address”错误。

2026-04-27

  • 将 v8 更新到 14.8 版本。

2026-04-17

  • 将 v8 更新到 14.7 版本。
  • 允许为动态 Workers 传递自定义限制。

2026-03-20

  • 将 v8 更新到 14.6 版本。

2026-01-29

  • 将 v8 更新到 14.5 版本。

2026-01-13

  • 将 v8 更新到 14.4 版本。

2025-12-19

  • 创建动态 Workers 时允许名称为 null。

2025-11-25

  • 将 v8 更新到 14.3 版本。

2025-10-25

  • WebSocket 消息大小上限已从 1 MiB 提高到 32 MiB。

2025-10-22

  • 以前仅在预览会话的开发者工具控制台中可见的警告,现在也会发送到 Tail Worker(如果已附加)。

2025-10-17

2025-09-18

  • 将 v8 更新到 14.1 版本。

2025-09-11

  • node:fs 和 Web File System API 现在可在 Workers 中使用。

2025-08-21

  • 将 v8 更新到 14.0 版本。
  • JavaScript 中的 Uint8Array 类型现在支持 base64 和十六进制操作。

2025-08-14

  • 启用 V8 沙箱,以提高隔离性和安全性。

2025-08-11

  • MessageChannel 和 MessagePort API 现在可在 Workers 中使用。

2025-06-27

  • 将 v8 更新到 13.9 版本。

2025-06-23

2025-06-04

  • 将 v8 更新到 13.8 版本。

2025-05-27

  • 过去在某些情况下,同一个 ctx 实例会被传递给事件处理程序的多次调用。现在我们始终为每个事件传递一个新对象。我们将此变更追溯应用于所有兼容性日期,因为我们认为它修复了某些 Worker 中的安全问题,并且不会破坏任何 Worker。不过,可以使用兼容性标志 nonclass_entrypoint_reuses_ctx_across_invocations 恢复旧行为。

2025-05-22

  • 启用了显式资源管理,并支持 Float16Array

2025-05-20

  • 将 v8 更新到 13.7 版本。

2025-04-16

  • 将 v8 更新到 13.6 版本。

2025-04-14

  • JSRPC 消息大小限制已提高到 32 MiB。

2025-04-03

  • WebSocket 客户端异常现在是 JS 异常,而不是内部错误。

2025-03-27

  • 将 v8 更新到 13.5 版本。

2025-02-28

  • 将 v8 更新到 13.4 版本。
  • 使用 nodejs_compat 时,新的 nodejs_compat_populate_process_env 兼容性标志会使 process.env 自动填充为该 Worker 所配置的文本绑定。

2025-02-26

  • Workers Builds 现在支持构建使用 pnpm 10 作为包管理器的项目。如果您的构建之前因该版本不受支持而失败,请重试构建,无需更改配置。

2025-02-13

  • Smart Placement 不再将 Workers 运行在其所绑定的 D1 数据库所在的同一位置。现在,所有使用 Smart Placement 的 Workers 都适用相同的放置逻辑,无论它们是否使用 D1 绑定。

2025-02-11

  • 当 Workers 因某些故障而产生“internal error”异常时,异常消息中可能会提供一个参考 ID,客户可以在与支持团队沟通时附上该 ID,以便更轻松地识别错误。例如,带有新消息的异常可能如下所示:internal error; reference = 0123456789abcdefghijklmn。

2025-01-31

  • 将 v8 更新到 13.3 版本。

2025-01-15

  • 即使代码恰好完全相同,运行时也不再在不同的 Worker 版本之间重用 isolate。我们认为这种“优化”带来的困惑大于其价值。

2025-01-14

  • 将 v8 更新到 13.2 版本。

2024-12-19

  • Cloudflare GitHub App 权限更新
    • Cloudflare 正在为 Cloudflare GitHub App 请求更新的权限,以启用诸如在您从模板开始时自动在您的 GitHub 账户中创建仓库并为您部署新仓库等功能。此功能即将推出,以提供更好的上手体验。
    • 请求的权限:
    • 受影响的用户:
      • 2024 年 12 月 19 日,GitHub 将发送主题为“[GitHub] Cloudflare Workers & Pages is requesting updated permission”的电子邮件,届时现有用户将收到更新权限的提示。
      • 新用户在安装该应用时,会在连接仓库的过程中看到更新后的权限。
    • 操作: 请查看并接受权限更新,以使用即将推出的功能。如果您拒绝或不采取任何操作,仍可以像现在一样通过 Cloudflare GitHub App 连接仓库并部署变更,但需要这些权限的新功能将不可用。
    • 有疑问? 请访问 Cloudflare Developers Discord 中的 #github-permissions-update 频道。

2024-11-18

  • 将 v8 更新到 13.1 版本。

2024-11-12

  • 修复了在 SQLite 支持的 Durable Object 的警报处理程序中调用 deleteAll() 时出现的异常。

2024-11-08

  • 将 SQLite 更新到 3.47 版本。

2024-10-21

  • 修复了与远程服务器通信时 WebSocket pong 消息的编码问题。此前,当 Worker 与外部服务器建立 WebSocket 连接时,服务器可能会因未能正确响应 ping 而过早关闭 WebSocket。客户端连接不受影响。

2024-10-14

  • 将 v8 更新到 13.0 版本。

2024-09-26

  • 您现在可以将 GitHub 或 GitLab 仓库连接到现有的 Worker,以便在执行 git push 时通过 Workers Builds 自动构建和部署您的变更。

2024-09-20

  • Workers 现在支持 [handle_cross_request_promise_resolution] 兼容性标志,该标志解决了在多个请求之间 await 和解析 Promise 时的某些极端情况。

2024-09-19

  • 改进了 Workers 和 Pages 的 UI 设置,简化了项目配置的创建和管理。如有问题或一般反馈,请提交此表单。

2024-09-16

  • 将 v8 更新到 12.9 版本。

2024-08-19

2024-08-15

  • 将 v8 更新到 12.8 版本。
  • 您现在可以在 Cloudflare Workers 中使用 Promise.try()。有关这个最近添加到 JavaScript 语言中的 API 的更多背景信息,请参阅 tc39/proposal-promise-try。

2024-08-14

  • 使用 nodejs_compat_v2 兼容性标志时,Node.js 的 setImmediate(fn) API 现在可在全局作用域中使用。
  • internal_writable_stream_abort_clears_queue 兼容性标志可确保某些 WritableStream 的 abort() 操作被立即处理而不是延迟处理,从而确保在流的消费者不再活动时能够正确中止该流。

2024-07-19

2024-07-18

  • 为 Tail Worker 事件新增 truncated 标志,用于指示事件缓冲区已满且事件正在被丢弃。

2024-07-17

  • 将 v8 更新到 12.7 版本。

2024-07-03

  • node:crypto 实现现在包含 scrypt(...) 和 scryptSync(...) API。
  • Workers 现在支持标准的 EventSource API。
  • 修复了一个问题:当客户端断开连接时,写入 HTTP 响应正文有时会挂起(有时会抛出异常)。现在它将始终抛出异常。

2024-07-01

2024-06-28

  • 修复了一个问题:如果在 Worker 首次启动后、第一个请求的第一次 I/O 之前调用 Date.now(),会返回有偏差的结果。返回值会向后偏移启动 Worker 所花费的 CPU 时间(编译和运行全局作用域),使第一次 I/O(例如第一次 fetch())看起来比实际更慢。此偏差与 Spectre 缓解措施无关,只是一个长期存在的问题。

2024-06-24

  • 由 Durable Object 内部操作抛出并传递给调用方的异常,现在可能会带有 .retryable: true 属性(如果异常可能由暂时性故障导致),或带有 .overloaded: true 属性(如果异常由过载导致)。

2024-06-20

  • 如果尝试使用 Deployments API 回滚到某个 Worker 版本,而该版本中某个密钥的值与当前部署版本不同,我们现在会提示进行额外确认。可以指定 ?force=true 查询参数以继续回滚。

2024-06-19

  • 使用 nodejs_compat 兼容性标志时,buffer 模块现在实现了 isAscii() 和 isUtf8() 方法。
  • 修复了一个问题:从对 Durable Objects 的 JS RPC 调用传播的异常缺少 .remote 属性,而对 Durable Objects 的 fetch() 调用所产生的异常则具有该属性。

2024-06-12

  • Blob 和 Body 对象现在包含新的 bytes() 方法,反映了 Web 标准中最近的新增内容。

2024-06-03

2024-05-17

  • 将 v8 更新到 12.6 版本。

2024-05-15

  • 新的 fetch_standard_url 兼容性标志将于 2024 年 6 月 3 日默认生效,它确保传入 fetch(...) API、new Request(...) 构造函数的 URL 以及重定向请求的 URL 都使用标准的 WHATWG URL 解析器进行解析。
  • DigestStream 现在更加高效,并公开了一个新的 bytesWritten 属性,用于指示写入摘要的字节数。

2024-05-13

2024-05-03

  • 修复了与 Durable Objects 之间的 RPC 未遵循输出门(output gate)的问题。
  • 在处理运行时提供的 BYOB 流(例如 response.body 或 request.body)时,可以使用 internal_stream_byob_return_view 兼容性标志提高 ReadableStreamBYOBReader 实现的标准合规性。该标志确保最终的读取结果始终包含一个 value 字段,其值被设置为一个空的 Uint8Array,且其底层 ArrayBuffer 与调用 read() 时传入的内存分配相同。
  • Web 平台标准的 reportError(err) 全局 API 现在可在 Workers 中使用。默认情况下,报告的错误将首先作为全局作用域上的 'error' 事件触发,然后同时在控制台输出和 Tail Worker 异常中报告。

2024-04-26

  • 将 v8 更新到 12.4 版本。

2024-04-11

  • 通过在流类原型上公开 desiredSize 和其他属性,提高了 Streams API 的规范合规性
  • 实现了新的 URL.parse(...) 方法。它提供了 URL 构造函数的替代方案,在遇到无效 URL 时不会抛出异常。
  • R2 绑定对象现在具有 storageClass 选项。可以在上传对象时设置此选项来指定 R2 存储类:标准或低频访问。该属性也会随对象元数据一起返回。

2024-04-05

2024-04-04

  • 对于每个请求通过 Cache API put() 上传的数据总量,不再有明确的限制。其他 Cache API 限制仍然适用。
  • 现已实现 Web 标准的 ReadableStream.from() API。该 API 可以从同步或异步可迭代对象创建 ReadableStream。

2024-04-03

2024-04-02

2024-04-01

  • 新的 unwrap_custom_thenables 兼容性标志使 Workers 能够在期望 Promise 的内部 API(例如 ctx.waitUntil(...) 方法)中接受自定义 thenable。
  • 使用 TransformStream 构造函数创建的 TransformStream 现在具有一个取消算法,会在流被取消或中止时调用。此变更是实现 WHATWG Streams 标准的一部分。
  • nodejs_compat 兼容性标志现在包含 node:test 中 MockTracker API 的实现。这并不是完整 node:test 模块的实现,目前也不包含模拟计时器。
  • 报告给 Tail Workers 的异常现在包含一个“stack”属性,其中含有异常的堆栈跟踪(如果可用)。

2024-03-11

  • 返回 Promise 的内置 API 现在会在 Promise 被拒绝时生成堆栈跟踪。此前,拒绝错误缺少堆栈跟踪。
  • 新的兼容性标志 fetcher_no_get_put_delete 会移除服务绑定和 Durable Object stub 上的 get()、put() 和 delete() 方法。自兼容性日期 2024-03-26 起,这将成为默认行为。这些方法原本被设计为 fetch() 的简单便捷封装,但从未被记录在文档中。
  • 将 v8 更新到 12.3 版本。

2024-02-24

  • v8 已更新到 12.2 版本。
  • 您现在可以在 Workers 中使用 Iterator helpers。
  • 您现在可以在 Workers 中使用 Set 上的新方法,例如 Set.intersection 和 Set.union。

2024-02-23

2023-12-04

2023-10-30

  • Workers 和 Pages Functions 定价新增了一种名为 Workers Standard 的用量模型。对于首次升级到 Workers 付费计划的账户,这现在是默认的用量模型。有关详细信息,请阅读博客文章。
  • 账户选择加入 Workers Standard 定价后,脚本 wrangler.toml 中设置的用量模型将被忽略。必须通过仪表板进行配置(Workers & Pages > 选择您的 Worker > Settings(设置)> Usage Model(用量模型))。
  • 使用 Standard 用量模型的 Workers 和 Pages Functions 可以为其 Workers 设置自定义 CPU 限制

2023-10-20

2023-10-18

  • 移除了每个 Worker 最多 3 个 Cron Trigger 的限制。账户级别对所有 Workers 中 Cron Trigger 总数的限制仍然适用。

2023-10-12

  • TCP Socket 的 WritableStream 现在会确保连接已打开后,才解析 close 返回的 Promise。

2023-10-09

2023-09-14

2023-07-14

2023-07-07

  • 使用 nodejs_compat 兼容性标志时,现在可以使用 Node.js process.env API 的实现。
  • 使用 nodejs_compat 兼容性标志时,现在可以使用 Node.js diagnostics_channel API 的实现。

2023-06-22

2023-06-19

  • 当无法建立连接时,TCP Sockets API 现在会报告更清晰的错误。
  • 将 V8 更新到 11.5。

2023-06-09

  • AbortSignal.any() 现已可用。
  • 将 V8 更新到 11.4。
  • 随着 WHATWG URL 规范的更新,URLSearchParams 类的 delete() 和 has() 方法现在接受可选的第二个参数,用于指定搜索参数的值。这可能是一项破坏性变更,因此受新的 urlsearchparams_delete_has_value_arg 和 url_standard 兼容性标志控制。
  • 新增 strict_compression_checks 兼容性标志,用于对 DecompressionStream 进行额外的错误检查。

2023-05-26

  • Durable Objects 新增了 Hibernatable WebSockets API(Beta)。Hibernatable WebSockets API 允许当前未运行事件处理程序(例如处理 WebSocket 消息或警报)的 Durable Object 在保持其 WebSocket 连接的同时从内存中移除(即“休眠”)。处于休眠状态的 Durable Object 不会产生可计费的持续时间(GB-秒)费用。

2023-05-16

  • 新的 connect() 方法允许您直接从 Workers 连接到任何使用 TCP 的服务。要了解 Workers 平台支持的其他协议,请访问新的协议文档。
  • 我们为流行的无服务器数据库提供商(包括 Neon、PlanetScale 和 Supabase)新增了原生数据库集成。原生集成会自动处理创建连接字符串并将其作为密钥添加到您的 Worker 的过程。
  • 您现在还可以从 Worker 通过 TCP 直接连接到数据库,首先支持的是 PostgreSQL。对 PostgreSQL 的支持基于流行的 pg 驱动程序,允许您从 Worker 通过 TLS 直接连接到任何 PostgreSQL 实例。
  • R2 Migrator(Super Slurper)可自动完成从现有对象存储提供商迁移到 R2 的过程,现已正式发布。

2023-05-15

  • Cursor 是一个经过训练、可回答有关 Cloudflare 开发者平台问题的实验性 AI 助手,现已开放预览!Cursor 可以回答有关 Workers 和 Cloudflare 开发者平台的问题,并且其本身就构建在 Workers 之上。您可以在公告博客中详细了解 Cursor。

2023-05-12

2023-05-05

  • 新的 nodeJsCompatModule 类型可与 Worker 包一起使用,以模拟 Node.js 环境。process 和 Buffer 等常见的 Node.js 全局变量将会存在,并且可以使用 require('...') 加载 Node.js 内置模块,而无需 node: 说明符前缀。
  • 修复了更新 Workers 时 WebSocket 连接会被断开的问题。现在,只有连接到 Durable Objects 的 WebSocket 会因该 Durable Object 代码的更新而断开。

2023-04-28

  • Web Crypto API 现在支持 Secure Curves 规范中定义的 Ed25519 和 X25519 曲线。
  • 全局 connect 方法已移至 cloudflare:sockets 模块。

2023-04-14

  • 本周没有对外可见的变更。

2023-04-10

  • URL.canParse(...) 是一个新的标准 API,用于测试输入字符串能否成功解析为 URL,而无需承担创建和抛出错误的额外开销。
  • Workers 特有的 IdentityTransformStream 和 FixedLengthStream 类现在支持为可写端指定 highWaterMark,用于通过标准的 writer.desiredSize/writer.ready 机制发出背压信号。

2023-03-24

  • 修复了 Wrangler tail 和仪表板实时日志中的一个问题,该问题导致 Administrator Read-Only 和 Workers Tail Read 角色无法成功实时查看 Workers 日志。

2023-03-09

  • 没有对外可见的变更。

2023-03-06

  • Workers Logpush 现在支持每行日志 300 个字符,此前的限制为每行 150 个字符。

2023-02-06

  • 修复了向 Durable Object 传输较大请求正文时速度意外缓慢的问题。
  • 此前,尝试访问未实现的标准 Request 和 Response 属性时会抛出错误。现在这些属性将保留为 undefined。

2023-01-31

  • request.cf 对象现在包含两个额外的属性:tlsClientHelloLength 和 tlsClientRandom。

2023-01-13

  • Durable Objects 现在可以通过新的子命名空间 API,将辖区与 idFromName 结合使用。
  • V8 已更新到 10.9。

这篇文档对您有帮助吗?