Change8

wrangler@4.117.0

Breaking Changes
📦 cloudflare-workersView on GitHub →
1 breaking🐛 1 fixes1 deprecations🔧 1 symbols

Summary

This release updates Miniflare to version 5.20260730.0-alpha, which includes changes to local testing paths and the removal of `containerEngine` from worker options.

⚠️ Breaking Changes

  • The `containerEngine` option has been removed from the worker options returned by `unstable_getMiniflareWorkerOptions`. If you were previously using this option to configure the container engine for a specific worker, you should now set `containerEngine` at the top level when creating a Miniflare instance.

Migration Steps

  1. If you were using `containerEngine` with `unstable_getMiniflareWorkerOptions`, move the `containerEngine` configuration to the top level when creating a Miniflare instance.

🐛 Bug Fixes

  • Local testing paths (`/cdn-cgi/*`) have been rewritten to prevent potential collisions with production routes. `wrangler dev` and the Vite plugin now transparently rewrite old paths to new ones (`/cdn-cgi/local/*` or `/__cf_local/*`), ensuring continued functionality. The new paths are: `/cdn-cgi/handler/scheduled` -> `/cdn-cgi/local/scheduled`, `/cdn-cgi/handler/email` -> `/cdn-cgi/local/email`, `/cdn-cgi/explorer/*` -> `/cdn-cgi/local/explorer/*`, `/cdn-cgi/mf/scheduled` -> `/cdn-cgi/local/scheduled`, `/cdn-cgi/mf/stream/*` -> `/__cf_local/stream/*`, `/cdn-cgi/mf/imagedelivery/*` -> `/__cf_local/imagedelivery/*`.

Affected Symbols

⚡ Deprecations

  • The `/cdn-cgi/mf/scheduled` path is deprecated.