miniflare@4.20260722.0
📦 cloudflare-workersView on GitHub →
✨ 1 features🐛 3 fixes🔧 11 symbols
Summary
This release introduces local development observability features, allowing detailed tracing of Worker invocations. It also includes dependency updates and bug fixes for queue batch errors, image handling, and runtime crash recovery in local development.
Migration Steps
- To enable local observability, set the environment variable `X_LOCAL_OBSERVABILITY=true`.
✨ New Features
- Add local-dev observability: `wrangler dev` and the Vite plugin now capture a trace for every local Worker invocation, including spans, logs, and `console.*` output, and requests crossing worker or Durable Object boundaries. This data can be explored via a new Observability tab in the Local Explorer (Traces and Events views) or a read-only SQL endpoint at `/cdn-cgi/explorer/api/local/observability/query`. Observability is off by default and can be enabled by setting `X_LOCAL_OBSERVABILITY=true`.
🐛 Bug Fixes
- Fix incorrect byte limit reported in the local Queues batch-size error: The `PayloadTooLargeError` for exceeding the local queue batch byte size now correctly interpolates the actual limit of `288000` bytes instead of a hardcoded `256000`.
- Update `sharp` to 0.35.2: `sharp` 0.35 removes its `install` lifecycle script, simplifying installation with package managers like pnpm. The local Images binding now correctly reports AVIF as `image/avif` in the `/info` endpoint and `cf.image` transform path, resolving an issue where it was treated as an unsupported type.
- Recover local development after the Workers runtime crashes: Miniflare now restarts `workerd` after post-startup crashes, allowing local development to continue. Startup crashes are still surfaced as fatal errors. The Cloudflare Vite plugin also restarts the Vite development server after `workerd` recovers to ensure environments, hot channels, and module runners are recreated.