本更新日志记录 Cloudflare 仪表板、Wrangler、API 和 workerd 运行时中对 Workers 的重要变更。这些变更不可配置。
这与兼容性日期和兼容性标志不同——后者允许你显式选择加入或退出 Workers 运行时的特定变更。
- 启用 FinalizationRegistry API。有关详细信息,请参阅 We shipped FinalizationRegistry in Workers: why you should never use it。
- 过去在某些情况下,同一个
ctx实例会被传递给事件处理程序的多次调用。现在我们始终为每个事件传递一个新对象。我们将此变更追溯应用于所有兼容性日期,因为我们认为它修复了某些 Worker 中的安全问题,并且不会破坏任何 Worker。不过,可以使用兼容性标志nonclass_entrypoint_reuses_ctx_across_invocations恢复旧行为。
- 将 v8 更新到 13.4 版本。
- 使用
nodejs_compat时,新的nodejs_compat_populate_process_env兼容性标志会使process.env自动填充为该 Worker 所配置的文本绑定。
- Workers Builds 现在支持构建使用 pnpm 10 作为包管理器的项目。如果您的构建之前因该版本不受支持而失败,请重试构建,无需更改配置。
- Smart Placement 不再将 Workers 运行在其所绑定的 D1 数据库所在的同一位置。现在,所有使用 Smart Placement 的 Workers 都适用相同的放置逻辑,无论它们是否使用 D1 绑定。
- 当 Workers 因某些故障而产生“internal error”异常时,异常消息中可能会提供一个参考 ID,客户可以在与支持团队沟通时附上该 ID,以便更轻松地识别错误。例如,带有新消息的异常可能如下所示:
internal error; reference = 0123456789abcdefghijklmn。
- Cloudflare GitHub App 权限更新
- Cloudflare 正在为 Cloudflare GitHub App 请求更新的权限,以启用诸如在您从模板开始时自动在您的 GitHub 账户中创建仓库并为您部署新仓库等功能。此功能即将推出,以提供更好的上手体验。
- 请求的权限:
- Repository Administration(读/写),用于创建仓库。
- Contents(读/写),用于将代码推送到所创建的仓库。
- 受影响的用户:
- 2024 年 12 月 19 日,GitHub 将发送主题为“[GitHub] Cloudflare Workers & Pages is requesting updated permission”的电子邮件,届时现有用户将收到更新权限的提示。
- 新用户在安装该应用时,会在连接仓库的过程中看到更新后的权限。
- 操作: 请查看并接受权限更新,以使用即将推出的功能。如果您拒绝或不采取任何操作,仍可以像现在一样通过 Cloudflare GitHub App 连接仓库并部署变更,但需要这些权限的新功能将不可用。
- 有疑问? 请访问 Cloudflare Developers Discord 中的 #github-permissions-update 频道。
- 修复了与远程服务器通信时 WebSocket pong 消息的编码问题。此前,当 Worker 与外部服务器建立 WebSocket 连接时,服务器可能会因未能正确响应 ping 而过早关闭 WebSocket。客户端连接不受影响。
- 您现在可以将 GitHub 或 GitLab 仓库连接到现有的 Worker,以便在执行 git push 时通过 Workers Builds 自动构建和部署您的变更。
- Workers 现在支持 [
handle_cross_request_promise_resolution] 兼容性标志,该标志解决了在多个请求之间 await 和解析 Promise 时的某些极端情况。
- 改进了 Workers 和 Pages 的 UI 设置,简化了项目配置的创建和管理。如有问题或一般反馈,请提交此表单。
- Workers 现在支持
allow_custom_ports兼容性标志,该标志允许使用fetch()调用自定义端口。
- 将 v8 更新到 12.8 版本。
- 您现在可以在 Cloudflare Workers 中使用
Promise.try()。有关这个最近添加到 JavaScript 语言中的 API 的更多背景信息,请参阅tc39/proposal-promise-try。
- 使用
nodejs_compat_v2兼容性标志时,Node.js 的setImmediate(fn)API 现在可在全局作用域中使用。 internal_writable_stream_abort_clears_queue兼容性标志可确保某些WritableStream的abort()操作被立即处理而不是延迟处理,从而确保在流的消费者不再活动时能够正确中止该流。
- 为 Tail Worker 事件新增
truncated标志,用于指示事件缓冲区已满且事件正在被丢弃。
node:crypto实现现在包含 scrypt(...) 和 scryptSync(...) API。- Workers 现在支持标准的 EventSource API。
- 修复了一个问题:当客户端断开连接时,写入 HTTP 响应正文有时会挂起(有时会抛出异常)。现在它将始终抛出异常。
- 修复了一个问题:如果在 Worker 首次启动后、第一个请求的第一次 I/O 之前调用
Date.now(),会返回有偏差的结果。返回值会向后偏移启动 Worker 所花费的 CPU 时间(编译和运行全局作用域),使第一次 I/O(例如第一次 fetch())看起来比实际更慢。此偏差与 Spectre 缓解措施无关,只是一个长期存在的问题。
- 如果尝试使用 Deployments API 回滚到某个 Worker 版本,而该版本中某个密钥的值与当前部署版本不同,我们现在会提示进行额外确认。可以指定
?force=true查询参数以继续回滚。
- 使用
nodejs_compat兼容性标志时,buffer模块现在实现了isAscii()和isUtf8()方法。 - 修复了一个问题:从对 Durable Objects 的 JS RPC 调用传播的异常缺少
.remote属性,而对 Durable Objects 的fetch()调用所产生的异常则具有该属性。
- 启用了 Smart Placement 的 Workers 现在支持渐进式部署。
- 新的
fetch_standard_url兼容性标志将于 2024 年 6 月 3 日默认生效,它确保传入fetch(...)API、new Request(...)构造函数的 URL 以及重定向请求的 URL 都使用标准的 WHATWG URL 解析器进行解析。 - DigestStream 现在更加高效,并公开了一个新的
bytesWritten属性,用于指示写入摘要的字节数。
- 将 v8 更新到 12.5 版本。
- fetch API 实现中的一个问题会导致 Blob 的内容类型被错误设置。该修复通过新的
blob_standard_mime_type兼容性标志发布。
- 修复了与 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 异常中报告。
- 通过在流类原型上公开
desiredSize和其他属性,提高了 Streams API 的规范合规性 - 实现了新的
URL.parse(...)方法。它提供了 URL 构造函数的替代方案,在遇到无效 URL 时不会抛出异常。 - R2 绑定对象现在具有
storageClass选项。可以在上传对象时设置此选项来指定 R2 存储类:标准或低频访问。该属性也会随对象元数据一起返回。
- 新的 JavaScript 原生远程过程调用(RPC)API 现已推出,让您可以更轻松地在 Workers 之间以及 Workers 与 Durable Objects 之间进行通信。
- 对于每个请求通过 Cache API
put()上传的数据总量,不再有明确的限制。其他 Cache API 限制仍然适用。 - 现已实现 Web 标准的
ReadableStream.from()API。该 API 可以从同步或异步可迭代对象创建ReadableStream。
- 启用
brotli_content_encoding兼容性标志后,Workers 运行时现在支持压缩和解压缩使用 Brotli 压缩算法编码的请求正文。有关详细信息,请参阅此文档部分。
- 您现在可以使用 Python 编写 Workers
- 新的
unwrap_custom_thenables兼容性标志使 Workers 能够在期望 Promise 的内部 API(例如ctx.waitUntil(...)方法)中接受自定义 thenable。 - 使用 TransformStream 构造函数创建的 TransformStream 现在具有一个取消算法,会在流被取消或中止时调用。此变更是实现 WHATWG Streams 标准的一部分。
nodejs_compat兼容性标志现在包含node:test中MockTrackerAPI 的实现。这并不是完整node:test模块的实现,目前也不包含模拟计时器。- 报告给 Tail Workers 的异常现在包含一个“stack”属性,其中含有异常的堆栈跟踪(如果可用)。
- 返回 Promise 的内置 API 现在会在 Promise 被拒绝时生成堆栈跟踪。此前,拒绝错误缺少堆栈跟踪。
- 新的兼容性标志
fetcher_no_get_put_delete会移除服务绑定和 Durable Object stub 上的get()、put()和delete()方法。自兼容性日期 2024-03-26 起,这将成为默认行为。这些方法原本被设计为fetch()的简单便捷封装,但从未被记录在文档中。 - 将 v8 更新到 12.3 版本。
- v8 已更新到 12.2 版本。
- 您现在可以在 Workers 中使用 Iterator helpers。
- 您现在可以在 Workers 中使用
Set上的新方法,例如Set.intersection和Set.union。
- Socket 现在支持
opened属性。 - Durable Object 警报处理程序现在有 15 分钟的最长实际运行时间限制。
- Workers 运行时现在提供 Web 平台标准的
navigator.sendBeacon(...)API。 - V8 已更新到 12.0。
- Workers 和 Pages Functions 定价新增了一种名为 Workers Standard 的用量模型。对于首次升级到 Workers 付费计划的账户,这现在是默认的用量模型。有关详细信息,请阅读博客文章。
- 账户选择加入 Workers Standard 定价后,脚本 wrangler.toml 中设置的用量模型将被忽略。必须通过仪表板进行配置(Workers & Pages > 选择您的 Worker > Settings(设置)> Usage Model(用量模型))。
- 使用 Standard 用量模型的 Workers 和 Pages Functions 可以为其 Workers 设置自定义 CPU 限制
- 新增
crypto_preserve_public_exponent兼容性标志,用于纠正 WebCrypto API 中 RSA 密钥的 algorithm 字段使用了错误类型的问题。
- TCP Socket 的 WritableStream 现在会确保连接已打开后,才解析
close返回的 Promise。
- Web 平台标准的
CustomEvent类现在可在 Workers 中使用。 - 修复了 WebCrypto API 中 RSA 密钥 algorithm 的
publicExponent字段类型错误的问题。请使用crypto_preserve_public_exponent兼容性标志启用新行为。
- 启用
nodejs_compat兼容性标志后,现在可以使用 Node.jsnode:cryptoAPI 的实现。
- 启用
nodejs_compat兼容性标志后,现在可以使用 Node.jsutil.MIMETypeAPI 的实现。
- 使用
nodejs_compat兼容性标志时,现在可以使用 Node.jsprocess.envAPI 的实现。 - 使用
nodejs_compat兼容性标志时,现在可以使用 Node.jsdiagnostics_channelAPI 的实现。
- 新增
strict_crypto_checks兼容性标志,用于启用额外的 Web Crypto API 错误和安全检查。 - 修复了 TCP Sockets API 中的一个回归问题:
connect("google.com:443")会因TypeError而失败。
- 当无法建立连接时,TCP Sockets API 现在会报告更清晰的错误。
- 将 V8 更新到 11.5。
AbortSignal.any()现已可用。- 将 V8 更新到 11.4。
- 随着 WHATWG URL 规范的更新,
URLSearchParams类的delete()和has()方法现在接受可选的第二个参数,用于指定搜索参数的值。这可能是一项破坏性变更,因此受新的urlsearchparams_delete_has_value_arg和url_standard兼容性标志控制。 - 新增
strict_compression_checks兼容性标志,用于对DecompressionStream进行额外的错误检查。
- Durable Objects 新增了 Hibernatable WebSockets API(Beta)。Hibernatable WebSockets API 允许当前未运行事件处理程序(例如处理 WebSocket 消息或警报)的 Durable Object 在保持其 WebSocket 连接的同时从内存中移除(即“休眠”)。处于休眠状态的 Durable Object 不会产生可计费的持续时间(GB-秒)费用。
- 新的
connect()方法允许您直接从 Workers 连接到任何使用 TCP 的服务。要了解 Workers 平台支持的其他协议,请访问新的协议文档。 - 我们为流行的无服务器数据库提供商(包括 Neon、PlanetScale 和 Supabase)新增了原生数据库集成。原生集成会自动处理创建连接字符串并将其作为密钥添加到您的 Worker 的过程。
- 您现在还可以从 Worker 通过 TCP 直接连接到数据库,首先支持的是 PostgreSQL。对 PostgreSQL 的支持基于流行的
pg驱动程序,允许您从 Worker 通过 TLS 直接连接到任何 PostgreSQL 实例。 - R2 Migrator(Super Slurper)可自动完成从现有对象存储提供商迁移到 R2 的过程,现已正式发布。
performance.now()和performance.timeOriginAPI 现在可以在 Cloudflare Workers 中使用。与Date.now()一样,出于安全原因,时间仅在 I/O 之后才会推进。
- 新的
nodeJsCompatModule类型可与 Worker 包一起使用,以模拟 Node.js 环境。process和Buffer等常见的 Node.js 全局变量将会存在,并且可以使用require('...')加载 Node.js 内置模块,而无需node:说明符前缀。 - 修复了更新 Workers 时 WebSocket 连接会被断开的问题。现在,只有连接到 Durable Objects 的 WebSocket 会因该 Durable Object 代码的更新而断开。
- Web Crypto API 现在支持 Secure Curves 规范中定义的 Ed25519 和 X25519 曲线。
- 全局
connect方法已移至cloudflare:sockets模块。
URL.canParse(...)是一个新的标准 API,用于测试输入字符串能否成功解析为 URL,而无需承担创建和抛出错误的额外开销。- Workers 特有的
IdentityTransformStream和FixedLengthStream类现在支持为可写端指定highWaterMark,用于通过标准的writer.desiredSize/writer.ready机制发出背压信号。
- 修复了 Wrangler tail 和仪表板实时日志中的一个问题,该问题导致 Administrator Read-Only 和 Workers Tail Read 角色无法成功实时查看 Workers 日志。
- Workers Logpush 现在支持每行日志 300 个字符,此前的限制为每行 150 个字符。
- 修复了向 Durable Object 传输较大请求正文时速度意外缓慢的问题。
- 此前,尝试访问未实现的标准
Request和Response属性时会抛出错误。现在这些属性将保留为undefined。
request.cf对象现在包含两个额外的属性:tlsClientHelloLength和tlsClientRandom。