●Change8

wrangler@4.124.0

Breaking Changes
📦 cloudflare-workersView on GitHub →
⚠ 2 breaking✨ 1 features🐛 6 fixes🔧 17 symbols

Summary

This release introduces the ability to link containers to Durable Objects from the export side and fixes several bugs related to D1, environment variable handling on Windows, and compatibility date resolution.

⚠️ Breaking Changes

  • The `containers[].class_name` field is now optional when linking a container to a Durable Object from the export side. If a container is referenced from the `exports` entry of a Durable Object, it only needs a `name`.
  • A container can now only be linked to one Durable Object export, and a Durable Object export can only be linked to one container. Previously, multiple containers could be linked to the same Durable Object export, which could lead to unexpected behavior or silent overwrites.

Migration Steps

  1. If you are linking containers to Durable Objects from the export side, ensure your `wrangler.jsonc` configuration uses the new `container` field within the `exports` object. If a container is referenced this way, `class_name` is no longer required for the container definition itself.

✨ New Features

  • Containers can now be attached to a Durable Object from its `exports` entry, allowing for a more flexible configuration of Durable Objects with associated containers.

🐛 Bug Fixes

  • Ensured `access.dev` is honored when running Workers with `@cloudflare/vitest-pool-workers`, so `ctx.access.getIdentity()` returns the configured identity.
  • Fixed `.env` loading on Windows to prevent leaking stale, differently-cased duplicate keys.
  • Normalized structural CRLF line endings before sending D1 commands to the remote query API to prevent `incomplete input: SQLITE_ERROR`.
  • Fixed D1 SQL statements to correctly handle lowercase `end` keywords when splitting SQL files into statements.
  • Resolved `--latest` flag for `wrangler deploy` and `wrangler versions upload` to the newest compatibility date supported by the installed runtime, preventing projects from becoming unrunnable after deployment.
  • Fixed spurious `Trailing comma jsonc(519)` warnings for `wrangler.jsonc` in VS Code 1.131+.

Affected Symbols

wrangler.jsonccontainersexportsdurable-objectclass_namecontainernamestoragelegacy-kvprocess.envwrangler d1 migrations apply --remotewrangler d1 execute --remote --commandwrangler deploy --latestwrangler versions upload --latestwrangler pages download config@cloudflare/vitest-pool-workersctx.access.getIdentity()