NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
npm, #1829 most downloaded on npm
Fun, full-featured, fully-local simulator for Cloudflare Workers
Latest stable
4.20260730.0
Last release 6 days ago
10 Nov 2026
Ships on a steady schedule
a new release about every 1 weeks
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
5 years old
1688 releases · first in 2021
Drag across the ruler to compare, or tap a release to open it.
The following dependency versions have been updated:
#11495 59534ba Thanks @dependabot! - chore: update dependencies of "miniflare" package
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20251128.0 | 1.20251202.0 |
The following dependency versions have been updated:
#11448 2b4813b Thanks @edmundhung! - Builds package with esbuild v0.27.0
#11419 5ee3780 Thanks @dependabot! - chore: update dependencies of "miniflare" package
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20251125.0 | 1.20251126.0 |
#11444 6e63b57 Thanks @dependabot! - chore: update dependencies of "miniflare" package
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20251126.0 | 1.20251127.0 |
#11457 71ab562 Thanks @dependabot! - chore: update dependencies of "miniflare" package
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20251127.0 | 1.20251128.0 |
#11391 5e937c1 Thanks @pmiguel! - Set minimum KV Cache TTL in Miniflare to 30 seconds
Your coding agent can read these notes before it upgrades. Set up the MCP server →
The following dependency versions have been updated:
#11376 69f4dc3 Thanks @dependabot! - chore: update dependencies of "miniflare" package
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20251118.0 | 1.20251121.0 |
#11396 1133c4d Thanks @dependabot! - chore: update dependencies of "miniflare" package
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20251121.0 | 1.20251125.0 |
#11348 4d61fae Thanks @petebacondarwin! - Add resilience to reading and writing the dev registry files
### Minor Changes - #11219 `524a6e5` Thanks @Ltadrian! - Implement Hyperdrive binding TLS miniflare proxy. This will allow for wrangler dev hyperdrive
The following dependency versions have been updated:
#11318 e5ec8cf Thanks @dependabot! - chore: update dependencies of "miniflare" package
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20251113.0 | 1.20251118.0 |
The following dependency versions have been updated:
c5c4ee5 Thanks @danlapid! - Add support for streaming tail consumers in local dev. This is an experimental new feature that allows you to register a tailStream() handler (compared to the existing tail() handler), which will receive streamed tail events from your Worker (compared to the tail() handler, which only receives batched events after your Worker has finished processing).#11235 d0041e2 Thanks @dependabot! - chore: update dependencies of "miniflare" package
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20251109.0 | 1.20251111.0 |
#11277 827d017 Thanks @dependabot! - chore: update dependencies of "miniflare" package
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20251111.0 | 1.20251113.0 |
We have seen some test flakes when there are a lot of Miniflare instances running in parallel. This appears to be that there is a small chance that a
#11202 305ffb3 Thanks @petebacondarwin! - Make Miniflare inspector proxy more resilient to selecting a free port
We have seen some test flakes when there are a lot of Miniflare instances running in parallel. This appears to be that there is a small chance that a port becomes unavailable between checking if it is free and using it.
#11231 46ccf0e Thanks @connyay! - Fix WebSocket proxy timeout by disabling Node.js HTTP timeouts
The dev registry proxy server was experiencing connection timeouts around 60-90 seconds for long-lived WebSocket connections. This was caused by Node.js's headersTimeout (defaults to min(60s, requestTimeout)) which is checked periodically by connectionsCheckingInterval (defaults to 30s).
When proxying WebSocket connections, the HTTP server's headers timeout was still active on the underlying socket, causing ERR_HTTP_REQUEST_TIMEOUT errors to be thrown and both client and server sockets to be destroyed.
Setting both headersTimeout: 0 and requestTimeout: 0 in createServer options disables timeout enforcement, allowing WebSocket connections to remain open indefinitely as needed.
The following dependency versions have been updated:
#11200 dd7d584 Thanks @dependabot! - chore: update dependencies of "miniflare" package
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20251105.0 | 1.20251106.1 |
#11232 4259256 Thanks @dependabot! - chore: update dependencies of "miniflare" package
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20251106.1 | 1.20251109.0 |
The following dependency versions have been updated:
#11185 1ae020d Thanks @dependabot! - chore: update dependencies of "miniflare" package
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20251011.0 | 1.20251105.0 |
### Patch Changes - #11084 `14f60e8` Thanks @Caio-Nogueira! - remove explicit disposal on void-returning rpc method on workflow binding. This was addi
14f60e8 Thanks @Caio-Nogueira! - remove explicit disposal on void-returning rpc method on workflow binding. This was adding extra dispose calls that were not needed, making the runtime noisy for the customers that saw internal errors unrelated to their code.### Patch Changes - #10919 `ca6c010` Thanks @Caio-Nogueira! - migrate workflow to use a wrapped binding
ca6c010 Thanks @Caio-Nogueira! - migrate workflow to use a wrapped bindingThe following dependency versions have been updated:
#10867 dd5f769 Thanks @austin-mc! - Add media binding support
#10768 8211bc9 Thanks @dario-piotrowicz! - Add handleStructuredLogs option that allows consumers of the workerd structured logs to print such logs without additional boilerplate
#10963 36d7054 Thanks @dependabot! - chore: update dependencies of "miniflare" package
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20251008.0 | 1.20251011.0 |
The following dependency versions have been updated:
#10917 42e256f Thanks @dependabot! - chore: update dependencies of "miniflare" package
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20251004.0 | 1.20251008.0 |
#10686 4462bc1 Thanks @alsuren! - Document that dumpSql is shared with d1-worker, and incorporate some D1 internal stats gathering machinery (which is currently unused by miniflare)
The following dependency versions have been updated:
The following dependency versions have been updated:
#10834 c8d5282 Thanks @dependabot! - chore: update dependencies of "miniflare" package
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20250927.0 | 1.20251001.0 |
#10673 bffd2a9 Thanks @jamesopstad! - Send a 404 response for unimplemented /cdn-cgi/handler/ routes.
The following dependency versions have been updated:
#10775 6ff41a6 Thanks @dependabot! - chore: update dependencies of "miniflare" package
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20250924.0 | 1.20250926.0 |
#10799 0c208e1 Thanks @dependabot! - chore: update dependencies of "miniflare" package
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20250926.0 | 1.20250927.0 |
#10683 2432022 Thanks @yuripave! - fix: api proxy preserve multiple Set-Cookie headers
#10769 0a554f9 Thanks @penalosa! - Mark more errors as UserError to disable Sentry reporting
The following dependency versions have been updated:
#10745 06e9a48 Thanks @dependabot! - chore: update dependencies of "miniflare" package
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20250923.0 | 1.20250924.0 |
The following dependency versions have been updated:
#10692 262393a Thanks @dependabot! - chore: update dependencies of "miniflare" package
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20250917.0 | 1.20250918.0 |
#10705 3ec1f65 Thanks @dependabot! - chore: update dependencies of "miniflare" package
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20250918.0 | 1.20250919.0 |
#10718 a434352 Thanks @dependabot! - chore: update dependencies of "miniflare" package
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20250919.0 | 1.20250922.0 |
#10729 328e687 Thanks @dependabot! - chore: update dependencies of "miniflare" package
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20250922.0 | 1.20250923.0 |
#10724 b4a4311 Thanks @penalosa! - Use Cap'n Web in workers-sdk
The following dependency versions have been updated:
6caf938 Thanks @edevil! - Added new attribute "allowed_sender_addresses" to send email binding.#10684 b59e3e1 Thanks @dependabot! - chore: update dependencies of "miniflare" package
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20250913.0 | 1.20250917.0 |
#10656 88132bc Thanks @edmundhung! - Improve tunnel cleanup in dev registry to reduce connection errors
The following dependency versions have been updated:
#10653 783afeb Thanks @dependabot! - chore: update dependencies of "miniflare" package
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20250906.0 | 1.20250913.0 |
### Minor Changes - #10596 `735785e` Thanks @penalosa! - Add Miniflare & Wrangler support for unbound Durable Objects
### Minor Changes - #10119 `336a75d` Thanks @dxh9845! - Add support for dynamically loading 'external' Miniflare plugins for unsafe Worker bindings (d
The following dependency versions have been updated:
#10568 dac302c Thanks @dependabot! - chore: update dependencies of "miniflare" package
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20250902.0 | 1.20250906.0 |
The following dependency versions have been updated:
#10535 4cb3370 Thanks @dependabot! - chore: update dependencies of "miniflare" package
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20250829.0 | 1.20250902.0 |
The following dependency versions have been updated:
#10502 22c8ae6 Thanks @dependabot! - chore: update dependencies of "miniflare" package
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20250823.0 | 1.20250829.0 |
#10471 38bdb78 Thanks @clintonsteiner! - chore: bump devalue version to 5.3.2
Allow durable objects to have enableSql, unsafeUniqueKey and unsafePreventEviction configurations set to undefined even if the same durable objects ar
#10437 452ad0b Thanks @dario-piotrowicz! - Loosen validation around different configurations for Durable Object
Allow durable objects to have enableSql, unsafeUniqueKey and unsafePreventEviction configurations set to undefined even if the same durable objects are defined with those configurations set to different values (this allows workers using external durable objects not to have to duplicate such configurations in their options)
The following dependency versions have been updated:
#10410 f964895 Thanks @dependabot! - chore: update dependencies of "miniflare" package
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20250816.0 | 1.20250823.0 |
| @cloudflare/workers-types | ^4.20250813.0 | ^4.20250823.0 |
### Minor Changes - #10012 `4728c68` Thanks @penalosa! - Support unsafe dynamic worker loading bindings
JSRPC over Dispatch Namespace Bindings
Adds a new option to Miniflare that allows users to register a callback function that gets invoked whenever the dev registry is updated with changes t
#10349 d54d8b7 Thanks @edmundhung! - feat: add unsafeHandleDevRegistryUpdate callback option to Miniflare
Adds a new option to Miniflare that allows users to register a callback function that gets invoked whenever the dev registry is updated with changes to external services that the current Worker depends on.
This callback is useful for scenarios where you need to react to changes in bound services, such as updating bindings tables or reloading configurations when dependent Workers are added, removed, or modified in the dev registry.
const mf = new Miniflare({
// ... other options
unsafeHandleDevRegistryUpdate(registry) {
console.log("Dev registry updated:", registry);
// Handle registry updates (e.g., reprint bindings, reload config)
},
});
ae0c806 Thanks @ruifigueira! - Browser Rendering for local development now uses @puppeteer/browsers package instead of puppeteerThe following dependency versions have been updated:
#10229 5020694 Thanks @dependabot! - chore: update dependencies of "miniflare" package
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20250803.0 | 1.20250813.0 |
| @cloudflare/workers-types | ^4.20250803.0 | ^4.20250813.0 |
The dev registry proxy server now correctly handles WebSocket upgrade requests and tunnels bidirectional frames between the workerd processes. Previou
#10273 1479fd0 Thanks @edmundhung! - fix: support WebSocket proxying to workerd
The dev registry proxy server now correctly handles WebSocket upgrade requests and tunnels bidirectional frames between the workerd processes. Previously, handshakes would fail due to missing upgrade logic.
#10281 05c5b28 Thanks @edmundhung! - fix: enable HTTPS support when proxying to workerd
The Miniflare dev-registry proxy previously assumed workerd would always use HTTP,
so enabling https on miniflare might caused connection failures in some setups.
This ensures proxying works whether the option is enabled or not.
#10142 e3d9703 Thanks @edmundhung! - fix: support mf.getBindings() when dev registry is enabled
Fixes a deadlock when using bindings from mf.getBindings() with the dev registry enabled. The deadlock happened because the runtime attempted to resolve a worker address via the loopback server, which was blocked by the Node.js thread waiting on the same runtime.
Address lookup has been moved to a proxy running in a worker thread to avoid blocking the main thread.
add a new top-level option named structuredWorkerdLogs that makes workerd print to stdout structured logs (stringified jsons of the following shape: {
#10004 b4d1373 Thanks @dario-piotrowicz! - add structuredWorkerdLogs option
add a new top-level option named structuredWorkerdLogs that makes workerd print to stdout structured logs (stringified jsons of the following shape: { timestamp: number, level: string, message: string }) instead of printing logs to stdout and stderr
#9556 8ba7736 Thanks @edmundhung! - Added a serviceName option to unsafeDirectSockets
This allows registering the current worker in the dev registry under its own name, but routing to a different service.
#10148 631f26d Thanks @dependabot! - chore: update dependencies of "miniflare" package
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20250730.0 | 1.20250801.0 |
| @cloudflare/workers-types | ^4.20250730.0 | ^4.20250801.0 |
#10203 d6ecd05 Thanks @dependabot! - chore: update dependencies of "miniflare" package
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20250801.0 | 1.20250803.0 |
| @cloudflare/workers-types | ^4.20250801.0 | ^4.20250803.0 |
#10176 07c8611 Thanks @devin-ai-integration! - Add macOS version validation to prevent EPIPE errors on unsupported macOS versions (below 13.5). Miniflare and C3 fail hard while Wrangler shows warnings but continues execution.
The following dependency versions have been updated:
#10129 9b61f44 Thanks @dependabot! - chore: update dependencies of "miniflare" package
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20250726.0 | 1.20250730.0 |
| @cloudflare/workers-types | ^4.20250726.0 | ^4.20250730.0 |
The following dependency versions have been updated:
#10075 82a5b2e Thanks @vicb! - fix the type of ForwardableEmailMessage
#10058 f8f7352 Thanks @edmundhung! - fix: service binding fetch over dev registry should work without host header
#9968 2df1d06 Thanks @dependabot! - chore: update dependencies of "miniflare" package
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20250712.0 | 1.20250726.0 |
| @cloudflare/workers-types | ^4.20250712.0 | ^4.20250726.0 |
### Minor Changes - #9971 `19794bf` Thanks @edmundhung! - feat: add stripDisablePrettyError option to control whether the header is stripped - #10041
#9971 19794bf Thanks @edmundhung! - feat: add stripDisablePrettyError option to control whether the header is stripped
#10041 059a39e Thanks @ruifigueira! - Add @cloudflare/plywright support for Browser Rendering local mode
Escape column and table names to prevent SQL syntax errors. Escape values based on their runtime type to support SQLite's flexible typing.
when bindings are registered deduplication logic is applied to make sure that the same binding is not unnecessarily registered multiple times, the cha
5b0fc9e Thanks @edmundhung! - Improved error logging to include error causes in stack traces with internal stack frames removed.#9854 ac08e68 Thanks @dario-piotrowicz! - fix incorrect bindings remote deduplication logic
when bindings are registered deduplication logic is applied to make sure that the same binding is not unnecessarily registered multiple times, the changes here fix the fact that such deduplication logic doesn't currently take into account whether bindings are used or not in remote mode (which is problematic when the same binding is used both in remote and local mode)
#9912 3bb69fa Thanks @dependabot! - chore: update dependencies of "miniflare" package
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20250709.0 | 1.20250710.0 |
| @cloudflare/workers-types | ^4.20250709.0 | ^4.20250710.0 |
#9930 274a826 Thanks @dependabot! - chore: update dependencies of "miniflare" package
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20250710.0 | 1.20250711.0 |
| @cloudflare/workers-types | ^4.20250710.0 | ^4.20250711.0 |
#9950 77d1cb2 Thanks @dependabot! - chore: update dependencies of "miniflare" package
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20250711.0 | 1.20250712.0 |
| @cloudflare/workers-types | ^4.20250711.0 | ^4.20250712.0 |
#9954 bf4c9ab Thanks @penalosa! - Support Images binding in getPlatformProxy()
The following dependency versions have been updated:
#9881 bb09e50 Thanks @dependabot! - chore: update dependencies of "miniflare" package
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20250705.0 | 1.20250708.0 |
| @cloudflare/workers-types | ^4.20250705.0 | ^4.20250708.0 |
#9894 25dbe54 Thanks @dependabot! - chore: update dependencies of "miniflare" package
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20250708.0 | 1.20250709.0 |
| @cloudflare/workers-types | ^4.20250708.0 | ^4.20250709.0 |
#9876 3bdec6b Thanks @edmundhung! - chore: update youch version
The following dependency versions have been updated:
ba69586 Thanks @simonabadoiu! - Browser Rendering local mode#9784 1a75f85 Thanks @Mkassabov! - fix inspector proxy not proxying workers created via setOptions
#9757 395f36d Thanks @dependabot! - chore: update dependencies of "miniflare" package
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20250617.0 | 1.20250705.0 |
| @cloudflare/workers-types | ^4.20250617.0 | ^4.20250705.0 |
#9855 6f344bf Thanks @petebacondarwin! - use logger (and log level) from miniflare for asset metadata parsing/loading logs
Now, using VSCode's built-in JavaScript Debug Terminals, there are just two steps: open a JS debug terminal and run wrangler dev (or vite dev). VSCode
#9535 56dc5c4 Thanks @penalosa! - In 2023 we announced breakpoint debugging support for Workers, which meant that you could easily debug your Worker code in Wrangler's built-in devtools (accessible via the [d] hotkey) as well as multiple other devtools clients, including VSCode. For most developers, breakpoint debugging via VSCode is the most natural flow, but until now it's required manually configuring a launch.json file, running wrangler dev, and connecting via VSCode's built-in debugger.
Now, using VSCode's built-in JavaScript Debug Terminals, there are just two steps: open a JS debug terminal and run wrangler dev (or vite dev). VSCode will automatically connect to your running Worker (even if you're running multiple Workers at once!) and start a debugging session.
### Patch Changes - #9689 `b137a6f` Thanks @emily-shen! - fix: correctly pass container engine config to miniflare
b137a6f Thanks @emily-shen! - fix: correctly pass container engine config to miniflareYou can enable this by setting MINIFLARE_WORKERD_CONFIG_DEBUG to a file path where you want the config to be written.
#9640 bfb791e Thanks @emily-shen! - Add ability to dump workerd config into a file for debugging.
You can enable this by setting MINIFLARE_WORKERD_CONFIG_DEBUG to a file path where you want the config to be written.
5162c51 Thanks @CarmenPopoviciu! - add ability to pull images for containers local dev### Patch Changes - #9605 `17d23d8` Thanks @emily-shen! - Add rebuild hotkey for containers local dev, and clean up containers at the end of a dev ses
17d23d8 Thanks @emily-shen! - Add rebuild hotkey for containers local dev, and clean up containers at the end of a dev session.### Patch Changes - #9586 `d1d34fe` Thanks @penalosa! - Remove the Mixed Mode naming in favour of "remote bindings"/"remote proxy"
The following dependency versions have been updated:
#9591 828b7df Thanks @dependabot! - chore: update dependencies of "miniflare" package
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20250612.0 | 1.20250617.0 |
| @cloudflare/workers-types | ^4.20250612.0 | ^4.20250617.0 |
#9576 2671e77 Thanks @vicb! - Add core local dev functionality for containers.
Adds a new WRANGLER_DOCKER_HOST env var to customise what socket to connect to.
The following dependency versions have been updated:
#9529 bd528d5 Thanks @dependabot! - chore: update dependencies of "miniflare" package
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20250604.0 | 1.20250612.0 |
| @cloudflare/workers-types | ^4.20250604.0 | ^4.20250612.0 |
#9582 2177fb4 Thanks @vicb! - Update capnp generated code from the workerd.capnp
#9506 36113c2 Thanks @penalosa! - Strip the CF-Connecting-IP header from outgoing fetches
#9493 e16fcc7 Thanks @vicb! - bump capnp-es to 0.0.11 in miniflare
Implements the proposal noted here https://github.com/cloudflare/workers-sdk/discussions/9143.
#9509 0b2ba45 Thanks @emily-shen! - feat: add static routing options via 'run_worker_first' to Wrangler
Implements the proposal noted here https://github.com/cloudflare/workers-sdk/discussions/9143.
This is now usable in wrangler dev and in production - just specify the routes that should hit the worker first with run_worker_first in your Wrangler config. You can also omit certain paths with ! negative rules.
#9475 931f467 Thanks @edmundhung! - add hello world binding that serves as as an explanatory example.
#9443 95eb47d Thanks @dario-piotrowicz! - add mixed-mode support for mtls bindings
The following dependency versions have been updated:
#9508 4ab5a40 Thanks @edmundhung! - fix: ensure default registry path matches wrangler settings"
#9385 485cd08 Thanks @dependabot! - chore: update dependencies of "miniflare" package
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20250525.0 | 1.20250604.0 |
| @cloudflare/workers-types | ^4.20250525.0 | ^4.20250604.0 |
#9469 e3b3ef5 Thanks @edmundhung! - refactor: the dev registry will now create a file watcher only when the Worker has a binding to external services.
This provides a default XDG app-path for the Dev Registry, which can be used to set the unsafeDevRegistryPath option in Miniflare and will be used by
#9173 fac2f9d Thanks @edmundhung! - feat: export getDefaultDevRegistryPath() utility
This provides a default XDG app-path for the Dev Registry, which can be used to set the unsafeDevRegistryPath option in Miniflare and will be used by both Wrangler and @cloudflare/vite-plugin.
#9313 92719a5 Thanks @edmundhung! - feat: add Dev Registry support
This change introduces two new options to support cross-process service bindings, durable objects and tail consumers via a file-system based registry, with backward compatibility to Wrangler’s implementation:
unsafeDevRegistryPath (string): Filesystem path to the Dev Registry directory.unsafeDevRegistryDurableObjectProxy (boolean): When enabled, exposes internal Durable Objects to other local dev sessions and allows Workers to connect to external Durable Objects.Example usage:
import { Miniflare } from "miniflare";
const mf = new Miniflare({
scriptPath: "./dist/worker.js",
unsafeDevRegistryPath: "/registry",
unsafeDevRegistryDurableObjectProxy: true,
// ...other options
});
#9440 8c7ce77 Thanks @penalosa! - Preserve original error messages
#9390 80e75f4 Thanks @penalosa! - Support additional Mixed Mode resources in Wrangler:
#9390 80e75f4 Thanks @penalosa! - Additional option for the Miniflare plugin interface to allow defining workerd extensions without having to include deduplication logic.
``js new Miniflare({ serviceBindings: { CUSTOM: { node: (req, res) => { res.end(Hello world); }, }, }, }); ``
#9387 e39a45f Thanks @jamesopstad! - Add logReady method to Miniflare Log class. This makes it possible to override the messages printed on server start.
#9376 fdae3f7 Thanks @jamesopstad! - Add support for Node.js style custom handlers for service bindings and outbound services. This makes it easier to integrate Miniflare with existing Node.js middleware and libraries as req and res objects can be used directly.
new Miniflare({
serviceBindings: {
CUSTOM: {
node: (req, res) => {
res.end(`Hello world`);
},
},
},
});
#9366 d9d937a Thanks @dependabot! - chore: update dependencies of "miniflare" package
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20250523.0 | 1.20250525.0 |
| @cloudflare/workers-types | ^4.20250523.0 | ^4.20250525.0 |
``js // Before this change / No defaultPersistRoot` new Miniflare({ kvPersist: undefined, // → "/(tmp)/kv" d1Persist: true, // → "$PWD/.mf/d1" r2Persi
#9330 34c71ce Thanks @edmundhung! - Add a new defaultPersistRoot option to control where plugins persist data when no path is provided.
// Before this change / No `defaultPersistRoot`
new Miniflare({
kvPersist: undefined, // → "/(tmp)/kv"
d1Persist: true, // → "$PWD/.mf/d1"
r2Persist: false, // → "/(tmp)/r2"
cachePersist: "/my-cache", // → "/my-cache"
});
// With `defaultPersistRoot`
new Miniflare({
defaultPersistRoot: "/storage",
kvPersist: undefined, // → "/storage/kv"
d1Persist: true, // → "/storage/d1"
r2Persist: false, // → "/(tmp)/r2"
cachePersist: "/my-cache", // → "/my-cache"
});
#9184 f7c82a4 Thanks @dependabot! - chore: update dependencies of "miniflare" package
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20250508.0 | 1.20250520.0 |
| @cloudflare/workers-types | ^4.20250508.0 | ^4.20250520.0 |
#9346 7ddd865 Thanks @dependabot! - chore: update dependencies of "miniflare" package
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20250520.0 | 1.20250523.0 |
| @cloudflare/workers-types | ^4.20250520.0 | ^4.20250523.0 |
#9335 6479fc5 Thanks @penalosa! - Redesign wrangler dev to more clearly present information and have a bit of a glow up ✨
#9106 e5ae13a Thanks @edmundhung! - fix: decouple KV plugin from secrets store plugin
The KV plugin previously configured both KV namespace and secrets store bindings with the same service name but different persistence paths, causing conflicts when both were defined. This change copies the KV binding implementation into the secrets store plugin and customizes its service name to prevent collisions.
### Patch Changes - #9277 `db5ea8f` Thanks @penalosa! - Support Mixed Mode for more binding types - #9245 `b87b472` Thanks @penalosa! - Support Mixed
### Patch Changes - #9256 `3b384e2` Thanks @penalosa! - Move the Analytics Engine simulator implementation from JSRPC to a Wrapped binding. This fixes
3b384e2 Thanks @penalosa! - Move the Analytics Engine simulator implementation from JSRPC to a Wrapped binding. This fixes a regression introduced in https://github.com/cloudflare/workers-sdk/pull/8935 that preventing Analytics Engine bindings working in local dev for Workers with a compatibility date prior to JSRPC being enabled.In v4.15.0, Miniflare began stripping the CF-Connecting-IP header via a global outbound service, which led to a TCP connection regression due to a bug
#9246 d033a7d Thanks @edmundhung! - fix: strip CF-Connecting-IP header within fetch
In v4.15.0, Miniflare began stripping the CF-Connecting-IP header via a global outbound service, which led to a TCP connection regression due to a bug in Workerd. This PR patches the fetch API to strip the header during local wrangler dev sessions as a temporary workaround until the underlying issue is resolved.
The following dependency versions have been updated:
#7914 37af035 Thanks @andyjessop! - fix(miniflare): strip CF-Connecting-IP header from all outbound requests
#9174 ceeb375 Thanks @dependabot! - chore: update dependencies of "miniflare" package
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20250507.0 | 1.20250508.0 |
| @cloudflare/workers-types | ^4.20250507.0 | ^4.20250508.0 |
#9181 349cffc Thanks @penalosa! - Add a mixed-mode-only browser rendering plugin
#9186 362cb0b Thanks @penalosa! - Support Mixed Mode Service Bindings in Miniflare
#9198 2cc8197 Thanks @kylecarbs! - fix: ensure the fetch proxy message port is started
While Node.js will start the message port automatically when a message event listener is added,
this diverges from the standard Web API for message ports, which require you to explicitly start
listening on the port.
#9168 6b42c28 Thanks @dario-piotrowicz! - add mixedModeConnectionString to the various binding configs
The following dependency versions have been updated:
#9092 df5d1f6 Thanks @dependabot! - chore: update dependencies of "miniflare" package
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20250428.0 | 1.20250506.0 |
| @cloudflare/workers-types | ^4.20250428.0 | ^4.20250506.0 |
#9160 4672bda Thanks @dependabot! - chore: update dependencies of "miniflare" package
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20250506.0 | 1.20250507.0 |
| @cloudflare/workers-types | ^4.20250506.0 | ^4.20250507.0 |
#9159 c6b3f10 Thanks @petebacondarwin! - bump esbuild version to fix regression in 0.25.0
### Patch Changes - #9089 `357d42a` Thanks @edmundhung! - fix: skip comment lines when parsing NODE_EXTRA_CA_CERTS
357d42a Thanks @edmundhung! - fix: skip comment lines when parsing NODE_EXTRA_CA_CERTSThe following dependency versions have been updated:
#9081 d2ecc76 Thanks @dependabot! - chore: update dependencies of "miniflare" package
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20250424.0 | 1.20250428.0 |
| @cloudflare/workers-types | ^4.20250424.0 | ^4.20250428.0 |
### Patch Changes - #9033 `2c50115` Thanks @dario-piotrowicz! - chore: convert wrangler.toml files into wrangler.jsonc ones
2c50115 Thanks @dario-piotrowicz! - chore: convert wrangler.toml files into wrangler.jsonc onesOne column per quarter.