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:
#9041 fc47c79 Thanks @dependabot! - chore: update dependencies of "miniflare" package
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20250422.0 | 1.20250424.0 |
| @cloudflare/workers-types | ^4.20250422.0 | ^4.20250424.0 |
#8860 0838f1b Thanks @teresalves! - KV: update error messages for 400 errors
In your configuration file, you can define a service binding with props:
#8640 5ce70bd Thanks @kentonv! - Add support for defining props on a Service binding.
In your configuration file, you can define a service binding with props:
{
"services": [
{
"binding": "MY_SERVICE",
"service": "some-worker",
"props": { "foo": 123, "bar": "value" }
}
]
}
These can then be accessed by the callee:
import { WorkerEntrypoint } from "cloudflare:workers";
export default class extends WorkerEntrypoint {
fetch() {
return new Response(JSON.stringify(this.ctx.props));
}
}
#9030 3f0adf3 Thanks @dependabot! - chore: update dependencies of "miniflare" package
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20250417.0 | 1.20250422.0 |
| @cloudflare/workers-types | ^4.20250417.0 | ^4.20250422.0 |
Your coding agent can read these notes before it upgrades. Set up the MCP server →
The following dependency versions have been updated:
41f095b Thanks @penalosa! - Internal refactor to move local analytics engine support from Wrangler to Miniflare#8993 2a7749b Thanks @dependabot! - chore: update dependencies of "miniflare" package
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20250416.0 | 1.20250417.0 |
| @cloudflare/workers-types | ^4.20250415.0 | ^4.20250417.0 |
The following dependency versions have been updated:
#8927 62c40d7 Thanks @dependabot! - chore: update dependencies of "miniflare" package
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20250410.0 | 1.20250416.0 |
| @cloudflare/workers-types | ^4.20250410.0 | ^4.20250415.0 |
### Minor Changes - #8887 `511be3d` Thanks @GregBrimble! - Add log message when Sec-Fetch-Mode: navigate is responsible for assets routing decision in
511be3d Thanks @GregBrimble! - Add log message when Sec-Fetch-Mode: navigate is responsible for assets routing decision in wrangler devThe following dependency versions have been updated:
#8873 f5413c5 Thanks @dependabot! - chore: update dependencies of "miniflare" package
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20250409.0 | 1.20250410.0 |
| @cloudflare/workers-types | ^4.20250409.0 | ^4.20250410.0 |
The following dependency versions have been updated:
#8859 b7ac367 Thanks @dependabot! - chore: update dependencies of "miniflare" package
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20250408.0 | 1.20250409.0 |
| @cloudflare/workers-types | ^4.20250408.0 | ^4.20250409.0 |
#8883 5388447 Thanks @penalosa! - fix: Only log requests to the Wrangler dev server once
The following dependency versions have been updated:
#8810 d454ad9 Thanks @dependabot! - chore: update dependencies of "miniflare" package
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20250405.0 | 1.20250408.0 |
| @cloudflare/workers-types | ^4.20250405.0 | ^4.20250408.0 |
### Minor Changes - #8375 `930ebb2` Thanks @penalosa! - Add support for email local dev and send_email binding ### Patch Changes - #8808 `afd93b9` Tha
The following dependency versions have been updated:
93267cf Thanks @edmundhung! - Support Secrets Store Secret bindings#8775 ec7e621 Thanks @LuisDuarte1! - chore: update dependencies of "miniflare" package
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20250404.0 | 1.20250405.0 |
| @cloudflare/workers-types | ^4.20250404.0 | ^4.20250405.0 |
The following dependency versions have been updated:
#8712 e0efb6f Thanks @dependabot! - chore: update dependencies of "miniflare" package
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20250321.0 | 1.20250404.0 |
| @cloudflare/workers-types | ^4.20250321.0 | ^4.20250404.0 |
#8747 0a401d0 Thanks @dario-piotrowicz! - fix: make sure that miniflare#setOptions allows the update of inspector ports
### Patch Changes - #8449 `007f322` Thanks @harryzcy! - update youch dependency to avoid vulnerable version of cookie
### Minor Changes - #8623 `cad99dc` Thanks @teresalves! - Add Miniflare Workers KV bulk get support ### Patch Changes - #8666 `f29f018` Thanks @penalo
The following dependency versions have been updated:
#8655 7682675 Thanks @emily-shen! - fix bug where assets in directories starting with . would crash the dev server
#8650 9c844f7 Thanks @dependabot! - chore: update dependencies of "miniflare" package
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20250320.0 | 1.20250321.0 |
| @cloudflare/workers-types | ^4.20250320.0 | ^4.20250321.0 |
The following dependency versions have been updated:
#8618 d8f1c49 Thanks @dependabot! - chore: update dependencies of "miniflare" package
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20250319.0 | 1.20250320.0 |
| @cloudflare/workers-types | ^4.20250319.0 | ^4.20250320.0 |
#8556 b7d6b7d Thanks @GregBrimble! - Add support for assets_navigation_prefer_asset_serving in Vite (dev and preview)
#8597 5d78760 Thanks @CarmenPopoviciu! - feat: Graduate experimental RPC support for Workers with assets in local dev
#8594 c0d0cd0 Thanks @CarmenPopoviciu! - fix: Add support for property accessors in local dev RPC for Workers with assets
The following dependency versions have been updated:
9adbd50 Thanks @knickish! - Enable the creation of MySQL Hypedrive configs via the Wrangler CLI.#8591 dae7bd4 Thanks @dependabot! - chore: update dependencies of "miniflare" package
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20250317.0 | 1.20250319.0 |
| @cloudflare/workers-types | ^4.20250317.0 | ^4.20250319.0 |
#8376 a25f060 Thanks @CarmenPopoviciu! - feat: Make local dev RPC behaviour on par with production for Workers with assets
Add a new unsafeInspectorProxy option to the miniflare worker options, if at least one worker has the option set then miniflare will establish a proxy
#8357 ff26dc2 Thanks @dario-piotrowicz! - feat: add new unsafeInspectorProxy option to miniflare
Add a new unsafeInspectorProxy option to the miniflare worker options, if
at least one worker has the option set then miniflare will establish a proxy
between itself and workerd for the v8 inspector APIs which exposes only the
requested workers to inspector clients. The inspector proxy communicates through
miniflare's inspectorPort and exposes each requested worker via a path comprised
of the worker's name
example:
import { Miniflare } from "miniflare";
const mf = new Miniflare({
// the inspector proxy will be accessible through port 9229
inspectorPort: 9229,
workers: [
{
name: "worker-a",
scriptPath: "./worker-a.js",
// enable the inspector proxy for worker-a
unsafeInspectorProxy: true,
},
{
name: "worker-b",
scriptPath: "./worker-b.js",
// worker-b is not going to be proxied
},
{
name: "worker-c",
scriptPath: "./worker-c.js",
// enable the inspector proxy for worker-c
unsafeInspectorProxy: true,
},
],
});
In the above example an inspector proxy gets set up which exposes worker-a and worker-b,
inspector clients can discover such workers via http://localhost:9229 and communicate with
them respectively via ws://localhost:9229/worker-a and ws://localhost:9229/worker-b
Note: this API is experimental, thus it's not being added to the public documentation and
it's prefixed by unsafe
The following dependency versions have been updated:
74b0c73 Thanks @lambrospetrou! - D1 local developer experience supports sessions API bookmarks#8538 5ae180e Thanks @emily-shen! - chore: update dependencies of "miniflare" package
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20250310.0 | 1.20250317.0 |
| @cloudflare/workers-types | ^4.20250310.0 | ^4.20250317.0 |
If you need to replicate the behaviour of the legacy node_compat feature, refer to https://developers.cloudflare.com/workers/wrangler/migration/update
#7334 869ec7b Thanks @penalosa! - The --node-compat flag and node_compat config properties are no longer supported as of Wrangler v4. Instead, use the nodejs_compat compatibility flag. This includes the functionality from legacy node_compat polyfills and natively implemented Node.js APIs. See https://developers.cloudflare.com/workers/runtime-apis/nodejs for more information.
If you need to replicate the behaviour of the legacy node_compat feature, refer to https://developers.cloudflare.com/workers/wrangler/migration/update-v3-to-v4/ for a detailed guide.
#7334 869ec7b Thanks @penalosa! - Packages in Workers SDK now support the versions of Node that Node itself supports (Current, Active, Maintenance). Currently, that includes Node v18, v20, and v22.
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
The following dependency versions have been updated:
#8423 8242e07 Thanks @dependabot! - chore: update dependencies of "miniflare" package
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20250224.0 | 1.20250310.0 |
| @cloudflare/workers-types | ^4.20250224.0 | ^4.20250310.0 |
#8390 53e6323 Thanks @GregBrimble! - Parse and apply metafiles (_headers and _redirects) in wrangler dev for Workers Assets
The following dependency versions have been updated:
#8338 2d40989 Thanks @GregBrimble! - feat: Upload _headers and _redirects if present with Workers Assets as part of wrangler deploy and wrangler versions upload.
#8251 da568e5 Thanks @dependabot! - chore: update dependencies of "miniflare" package
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20250214.0 | 1.20250224.0 |
| @cloudflare/workers-types | ^4.20250214.0 | ^4.20250224.0 |
#8288 cf14e17 Thanks @CarmenPopoviciu! - feat: Add assets Proxy Worker skeleton in miniflare
This commit implements a very basic Proxy Worker skeleton, and wires it in the "pipeline" miniflare creates for assets. This Worker will be incrementally worked on, but for now, the current implementation will forward all incoming requests to the Router Worker, thus leaving the current assets behaviour in local dev, the same.
This is an experimental feature available under the --x-assets-rpc flag: wrangler dev --x-assets-rpc.
#8355 79c7810 Thanks @GregBrimble! - fix: Add default empty router config for assets in Miniflare
### Patch Changes - #8274 `fce642d` Thanks @emily-shen! - fix bindings to entrypoints on the same worker in workers with assets - #8289 `a4909cb` Than
### Patch Changes - #8247 `a9a4c33` Thanks @GregBrimble! - feat: Omits Content-Type header for files of an unknown extension in Workers Assets - #8239
#8247 a9a4c33 Thanks @GregBrimble! - feat: Omits Content-Type header for files of an unknown extension in Workers Assets
#8239 6cae13a Thanks @edmundhung! - fix: allow the fetchMock option to be parsed upfront before passing it to Miniflare
The following dependency versions have been updated:
#8171 5e06177 Thanks @dependabot! - chore: update dependencies of "miniflare" package
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20250204.0 | 1.20250214.0 |
| @cloudflare/workers-types | ^4.20250204.0 | ^4.20250214.0 |
### Patch Changes - #7950 `4db1fb5` Thanks @cmackenzie1! - Add local binding support for Worker Pipelines
4db1fb5 Thanks @cmackenzie1! - Add local binding support for Worker PipelinesThe following dependency versions have been updated:
#8032 c80dbd8 Thanks @dependabot! - chore: update dependencies of "miniflare" package
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20250129.0 | 1.20250204.0 |
| @cloudflare/workers-types | ^4.20250129.0 | ^4.20250204.0 |
#7290 0c0374c Thanks @emily-shen! - fix: add support for workers with assets when running multiple workers in one wrangler dev instance
https://github.com/cloudflare/workers-sdk/pull/7251 added support for running multiple Workers in one wrangler dev/miniflare session. e.g. wrangler dev -c wrangler.toml -c ../worker2/wrangler.toml, which among other things, allowed cross-service RPC to Durable Objects.
However this did not work in the same way as production when there was a Worker with assets - this PR should fix that.
The following dependency versions have been updated:
#7971 ab49886 Thanks @dependabot! - chore: update dependencies of "miniflare" package
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20250124.0 | 1.20250129.0 |
| @cloudflare/workers-types | ^4.20250121.0 | ^4.20250129.0 |
### Patch Changes - #7788 `cf4f47a` Thanks @penalosa! - Switch to capnp-es over capnp-ts
The following dependency versions have been updated:
#7890 40f89a9 Thanks @dependabot! - chore: update dependencies of "miniflare" package
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20241230.0 | 1.20250124.0 |
| @cloudflare/workers-types | ^4.20241230.0 | ^4.20250121.0 |
### Patch Changes - #7738 `8e9aa40` Thanks @penalosa! - Use TEXT bindings for plain text values in Miniflare. This is an internal detail that should h
### Minor Changes - #7702 `78bdec5` Thanks @penalosa! - Support the CF-Connecting-IP header, which will be available in your Worker to determine the I
78bdec5 Thanks @penalosa! - Support the CF-Connecting-IP header, which will be available in your Worker to determine the IP address of the client that initiated a request.2c76887 Thanks @lambrospetrou! - Fix D1 exports to properly pad HEX strings for binary values.The following dependency versions have been updated:
#7652 b4e0af1 Thanks @dependabot! - chore: update dependencies of "miniflare" package
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20241218.0 | 1.20241230.0 |
| @cloudflare/workers-types | ^4.20241218.0 | ^4.20241230.0 |
The following dependency versions have been updated:
#7589 1488e11 Thanks @dependabot! - chore: update dependencies of "miniflare" package
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20241205.0 | 1.20241218.0 |
| @cloudflare/workers-types | ^4.20241205.0 | ^4.20241218.0 |
#7575 7216835 Thanks @LuisDuarte1! - Make Instance.status() return type the same as production
The following dependency versions have been updated:
#7464 21a9e24 Thanks @dependabot! - chore: update dependencies of "miniflare" package
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20241106.2 | 1.20241205.0 |
| @cloudflare/workers-types | ^4.20241106.0 | ^4.20241205.0 |
The following dependency versions have been updated:
#7418 ac87395 Thanks @dependabot! - chore: update dependencies of "miniflare" package
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20241106.1 | 1.20241106.2 |
| @cloudflare/workers-types | ^4.20241106.0 | ^4.20241106.0 |
#7399 b3d2e7d Thanks @emily-shen! - fix: update queues max_batch_timeout limit from 30s to 60s
### Minor Changes - #7286 `563439b` Thanks @LuisDuarte1! - Add proper engine persistance in .wrangler and fix multiple workflows in miniflare
563439b Thanks @LuisDuarte1! - Add proper engine persistance in .wrangler and fix multiple workflows in miniflareThe following dependency versions have been updated:
#7187 1db7846 Thanks @dependabot! - chore: update dependencies of "miniflare" package
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20241022.0 | 1.20241106.1 |
| @cloudflare/workers-types | ^4.20241022.0 | ^4.20241106.0 |
The following dependency versions have been updated:
#7066 760e43f Thanks @dependabot! - chore: update dependencies of "miniflare" package
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20241018.1 | 1.20241022.0 |
| @cloudflare/workers-types | ^4.20241018.0 | ^4.20241022.0 |
#7045 5ef6231 Thanks @RamIdeas! - Add preliminary support for Workflows in wrangler dev
The following dependency versions have been updated:
#7035 809193e Thanks @dependabot! - chore: update dependencies of "miniflare" package
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20241011.1 | 1.20241018.1 |
| @cloudflare/workers-types | ^4.20241011.0 | ^4.20241018.0 |
The following dependency versions have been updated:
#6961 5761020 Thanks @dependabot! - chore: update dependencies of "miniflare" package
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20241004.0 | 1.20241011.1 |
| @cloudflare/workers-types | ^4.20241004.0 | ^4.20241011.0 |
#6943 7859a04 Thanks @sdnts! - fix: local queues now respect consumer max delays and retry delays properly
The following dependency versions have been updated:
#6949 c863183 Thanks @dependabot! - chore: update dependencies of "miniflare" package
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20240925.0 | 1.20241004.0 |
| @cloudflare/workers-types | ^4.20240925.0 | ^4.20241004.0 |
Renamed path -> directory, bindingName -> binding.
#6835 5c50949 Thanks @emily-shen! - fix: rename asset plugin options slightly to match wrangler.toml better
Renamed path -> directory, bindingName -> binding.
The following dependency versions have been updated:
#6826 5e2e62c Thanks @dependabot! - chore: update dependencies of "miniflare" package
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20240909.0 | 1.20240925.0 |
| @cloudflare/workers-types | ^4.20240909.0 | ^4.20240925.0 |
#6824 1c58a74 Thanks @petebacondarwin! - fix: teach Miniflare about node_compat version date switch
A compatibility of Sept 23, 2024 or later means that nodejs_compat is equivalent to nodejs_compat_v2.
Some characters like [ ] @ are encoded by encodeURIComponent() but are often requested at an unencoded URL path. This change will make assets with fil
#6728 1ca313f Thanks @emily-shen! - fix: remove filepath encoding on asset upload and handle sometimes-encoded characters
Some characters like [ ] @ are encoded by encodeURIComponent() but are often requested at an unencoded URL path. This change will make assets with filenames with these characters accessible at both the encoded and unencoded paths, but to use the encoded path as the canonical one, and to redirect requests to the canonical path if necessary.
### Patch Changes - #6736 `2ddbb65` Thanks @emily-shen! - fix: reflect file changes when using dev with workers + assets
2ddbb65 Thanks @emily-shen! - fix: reflect file changes when using dev with workers + assetsPR #5570 introduced a regression in Miniflare, namely that declaring Queue Producers like queueProducers: { "MY_QUEUE": "my-queue" } no longer works.
#6514 2407c41 Thanks @CarmenPopoviciu! - fix: Fix Miniflare regression introduced in #5570
PR #5570 introduced a regression in Miniflare, namely that declaring Queue Producers like queueProducers: { "MY_QUEUE": "my-queue" } no longer works. This commit fixes the issue.
Fixes #5908
### Patch Changes - #6719 `5b5dd95` Thanks @sdnts! - fix: Respect delivery delays for Queue consumers in local dev mode
### Minor Changes - #6647 `d68e8c9` Thanks @joshthoward! - feat: Configure SQLite backed Durable Objects in local dev
d68e8c9 Thanks @joshthoward! - feat: Configure SQLite backed Durable Objects in local devThe following dependency versions have been updated:
#6673 3f5b934 Thanks @dependabot! - chore: update dependencies of "miniflare" package
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20240821.1 | 1.20240909.0 |
| @cloudflare/workers-types | ^4.20240821.1 | ^4.20240909.0 |
Note: the returned binding values are no-op/passthrough that can be used inside node.js, meaning that besides direct connections via the connect metho
#6627 5936282 Thanks @GregBrimble! - fix: Fixes max asset count error message to properly report count of assets
#6612 6471090 Thanks @dario-piotrowicz! - fix: add hyperdrive bindings support in getBindings
Note: the returned binding values are no-op/passthrough that can be used inside node.js, meaning
that besides direct connections via the connect methods, all the other values point to the
same db connection specified in the user configuration
One column per quarter.