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 10 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
6 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:
#14490 75d8cb0 Thanks @petebacondarwin! - Update dependencies of "miniflare", "wrangler"
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20260625.1 | 1.20260629.1 |
#14478 f10d4ad Thanks @dependabot! - Update dependencies of "miniflare", "wrangler"
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20260629.1 | 1.20260630.1 |
#14490 75d8cb0 Thanks @petebacondarwin! - Fix edge cases on the local R2 public bucket endpoint (/cdn-cgi/local/r2/public) to match r2.dev: write methods are rejected with 401, malformed/multiple/inverted ranges with 400 and unsatisfiable ranges (including bytes=-0) with 416, Range is honored on HEAD requests with a bodyless 206, Content-Range is correct for suffix ranges, object keys are percent-decoded exactly once (keys containing a literal % no longer fail), and objects stored without a content type are served as application/octet-stream instead of omitting the Content-Type header. Unread object bodies are also cancelled (on HEAD and unsatisfiable-range responses) instead of leaking a read stream until garbage collection.
#14490 75d8cb0 Thanks @petebacondarwin! - Add Workflow introspection to createTestHarness()
Worker handles can now introspect Workflow bindings by name, allowing tests to disable sleeps, mock step results, and wait for Workflow outcomes. Tests can introspect a known Workflow instance by ID or track instances created after introspection starts.
const harness = createTestHarness({
workers: [{ configPath: "./wrangler.json" }],
});
const worker = harness.getWorker();
await using workflow = await worker.introspectWorkflow("MY_WORKFLOW");
await workflow.modifyAll((modifier) =>
modifier.disableSleeps([{ name: "wait-for-approval" }])
);
const response = await worker.fetch("/start-workflow");
const [instance] = await workflow.get();
await instance.waitForStatus("complete");
Your coding agent can read these notes before it upgrades. Set up the MCP server →
The following dependency versions have been updated:
#14406 3b743c1 Thanks @dependabot! - Update dependencies of "miniflare", "wrangler"
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20260623.1 | 1.20260625.1 |
The following dependency versions have been updated:
#14364 a085dec Thanks @dependabot! - Update dependencies of "miniflare", "wrangler"
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20260617.1 | 1.20260619.1 |
#14383 9a0de8f Thanks @dependabot! - Update dependencies of "miniflare", "wrangler"
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20260619.1 | 1.20260621.1 |
#14397 fab565f Thanks @dependabot! - Update dependencies of "miniflare", "wrangler"
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20260621.1 | 1.20260623.1 |
A Uint8Array returned from a Workflows step under wrangler dev was serialised together with its full underlying ArrayBuffer, causing a raw SQLITE_TOOB
#14118 b38823f Thanks @aicayzer! - Fix Uint8Array step outputs in local Workflows being persisted with the full backing ArrayBuffer
A Uint8Array returned from a Workflows step under wrangler dev was serialised together with its full underlying ArrayBuffer, causing a raw SQLITE_TOOBIG error at view sizes well below the documented 1MiB step-output limit. For example, a 200KB view sliced from an 800KB buffer (a common pattern from crypto.getRandomValues or arr.slice(...) on a larger pool) would fail. The view's bytes are now copied to a tight buffer before persistence, bringing local behaviour in line with production. Fixes #14101.
GHSA-96hv-2xvq-fx4p / CVE-2026-48779 (high severity) reports a remote memory-exhaustion DoS in ws@<8.21.0: a peer sending a high volume of tiny fragme…
#14347 673b09e Thanks @jamesopstad! - Update undici from 7.24.8 to 7.28.0
#14346 e930bd4 Thanks @haidargit! - Bump ws from 8.20.1 to 8.21.0 to address GHSA-96hv-2xvq-fx4p
GHSA-96hv-2xvq-fx4p / CVE-2026-48779 (high severity) reports a remote memory-exhaustion DoS in ws@<8.21.0: a peer sending a high volume of tiny fragments and data chunks over modest network traffic can crash a ws server or client via OOM. The fix shipped in ws@8.21.0 (commit 2b2abd45, released 2026-05-22), which also introduces the maxBufferedChunks and maxFragments options. This change bumps the workspace catalog entry so that miniflare, wrangler, and @cloudflare/vite-plugin all pick up the patched release.
#14314 5c3bb11 Thanks @harryzcy! - Bump esbuild to 0.28.1
This update includes several bug fixes from esbuild versions 0.27.3 through 0.28.1. See the esbuild changelog for details.
#14331 296ad65 Thanks @dependabot! - Update dependencies of "miniflare", "wrangler"
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20260616.1 | 1.20260617.1 |
fetch(url, { cf: { image: { ... } } }) now transforms images locally via Sharp, instead of returning the original bytes unchanged. This mirrors the pr
#14221 0e055d3 Thanks @mglewis! - Support cf.image (transform via Workers) image transformations in local dev
fetch(url, { cf: { image: { ... } } }) now transforms images locally via Sharp, instead of returning the original bytes unchanged. This mirrors the production "transform via Workers" feature, so Workers already using cf.image behave much more closely to production in wrangler dev.
As with the Images binding, cf.image transforms require Sharp to be installed — transforms are silently skipped if Sharp is unavailable.
#14271 27db82c Thanks @dependabot! - Update dependencies of "miniflare", "wrangler"
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20260611.1 | 1.20260612.1 |
#14298 2a6a26b Thanks @dependabot! - Update dependencies of "miniflare", "wrangler"
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20260612.1 | 1.20260615.1 |
#14317 9a424ed Thanks @dependabot! - Update dependencies of "miniflare", "wrangler"
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20260615.1 | 1.20260616.1 |
#14287 41f391f Thanks @edmundhung! - Improve errors for missing resource bindings
When methods like getKVNamespace() or getR2Bucket() are called with a binding name that is not configured for that resource type, Miniflare now reports the expected binding type in the error message.
Each local R2 bucket is now exposed under /cdn-cgi/local/r2/public/ / on the existing user-facing dev server. The is the bucket's id when set, otherwi
#14119 2047a32 Thanks @tahmid-23! - Add support for serving R2 bucket objects publicly via the dev server
Each local R2 bucket is now exposed under /cdn-cgi/local/r2/public/<bucket-id>/<key> on the existing user-facing dev server. The <bucket-id> is the bucket's id when set, otherwise its binding name. Buckets with a remoteProxyConnectionString are not exposed. The endpoint supports GET and HEAD, range requests, conditional headers, and forwards stored HTTP metadata.
#14246 f3990b2 Thanks @dependabot! - Update dependencies of "miniflare", "wrangler"
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20260609.1 | 1.20260610.1 |
#14256 4597f08 Thanks @dependabot! - Update dependencies of "miniflare", "wrangler"
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20260610.1 | 1.20260611.1 |
The following dependency versions have been updated:
#14192 d076bcc Thanks @dependabot! - Update dependencies of "miniflare", "wrangler"
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20260603.1 | 1.20260605.1 |
#14217 24497d0 Thanks @dependabot! - Update dependencies of "miniflare", "wrangler"
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20260605.1 | 1.20260608.1 |
#14231 4bb572f Thanks @dependabot! - Update dependencies of "miniflare", "wrangler"
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20260608.1 | 1.20260609.1 |
#14177 48c4ff0 Thanks @ktKongTong! - Enable local scheduled handler dispatch for Workers + Assets (#9882)
It is now possible to trigger a scheduled handler on a Worker that has assets.
Pre-launch rename of the public binding type from web_search to websearch so the on-the-wire shape matches the product name (Web Search). The wrangler
#14164 b502d54 Thanks @G4brym! - Rename the web_search binding kind to websearch
Pre-launch rename of the public binding type from web_search to websearch so the on-the-wire shape matches the product name (Web Search). The wrangler config key, the binding-type string sent to the Cloudflare API, and the miniflare option key all move from web_search / webSearch to websearch.
Update your wrangler config:
- "web_search": { "binding": "WEBSEARCH" }
+ "websearch": { "binding": "WEBSEARCH" }
The runtime WebSearch type exposed on env.WEBSEARCH is unchanged.
#13863 3b8b80a Thanks @aslakhellesoy! - Support cross-worker workflow bindings via the dev registry
When a workflow binding has a scriptName that refers to a worker registered in another Miniflare instance (via unsafeDevRegistryPath), miniflare now reroutes the engine's USER_WORKFLOW binding through the dev-registry-proxy worker — the same mechanism Durable Objects already use for cross-worker scriptName bindings.
Previously the workflow engine was bound directly to a local service core:user:<scriptName>, so workerd refused to start when that script lived in a different process.
This unblocks getPlatformProxy() (and any other split-Miniflare setup) for users whose workflow class is defined in a separate worker — for example SvelteKit/Remix on Cloudflare, where adapter-cloudflare's dev integration runs the user's worker in a sidecar.
See #7459.
#14175 a3eea27 Thanks @dependabot! - Update dependencies of "miniflare", "wrangler"
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20260601.1 | 1.20260603.1 |
#14081 1fdd8de Thanks @dario-piotrowicz! - Detect early workerd exit instead of hanging indefinitely
When workerd exits during startup before writing all expected listen events to the control file descriptor (e.g. due to an IPv6 bind failure, permission error, or missing library), Miniflare's waitForPorts() would block forever. This caused wrangler dev to stall at "Starting local server..." with no error and no timeout.
The fix races waitForPorts() against the child process exit event so that any unexpected workerd termination is detected immediately. When workerd exits early, Miniflare now throws ERR_RUNTIME_FAILURE with the runtime's stderr output included in the error message, making the root cause diagnosable without external tools.
The following dependency versions have been updated:
#14147 e06cbb7 Thanks @dependabot! - Update dependencies of "miniflare", "wrangler"
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20260529.1 | 1.20260601.1 |
#14086 4ef790b Thanks @dario-piotrowicz! - Use 127.0.0.1 instead of localhost for the runtime inspector address
On systems where getaddrinfo("localhost") returns ::1 but IPv6 is disabled at the kernel level, workerd fails to bind the inspector socket and silently continues without emitting the listen-inspector event to the control FD. This caused wrangler dev to hang indefinitely at "Starting local server..." with no error output.
Using 127.0.0.1 explicitly is consistent with DEFAULT_HOST, --debug-port, and resolveLocalhost() already in the codebase.
#14105 337e912 Thanks @dario-piotrowicz! - Remove trailing periods from URLs in terminal output
URLs printed to the terminal with a sentence-ending period (e.g. https://example.com/path.) would include the period when clicked in some terminal emulators, causing 404 errors. This removes trailing periods from all URLs displayed in CLI output across wrangler, miniflare, vitest-pool-workers, and workers-utils.
#14112 3a746ac Thanks @penalosa! - Pin non-bundled runtime dependencies to exact versions
Dependencies that are not bundled into a package's published output are installed directly into consumers' dependency trees, so they are now pinned to exact versions instead of semver ranges. This closes a supply-chain gap where an unpinned external dependency could resolve to a compromised upstream release on a fresh install. A new pnpm check:pinned-deps lint enforces this for all published packages (and for the shared pnpm catalog) going forward.
The old pipeline field is still accepted but deprecated and will emit a warning.
#14087 e3c862a Thanks @edmundhung! - Add support for the new web_search binding kind.
Cloudflare Web Search is a managed, zero-setup web discovery primitive for agents and Workers. Declare the binding as a single object in wrangler.jsonc:
{
"web_search": { "binding": "WEBSEARCH" }
}
There is exactly one shared web corpus, so there is no namespace, instance, or other field to specify -- only the variable name. The binding exposes a single search() method that returns URLs and catalog metadata for a query. Web Search is discovery-only -- to read a result's content the caller invokes the global fetch() API against the result's url.
The binding is always remote in local development: Miniflare proxies to the production Web Search service via the remote-bindings transport. Adds the websearch.run OAuth scope to wrangler login.
Also adds a wrangler websearch search command for running ad-hoc queries from the CLI:
npx wrangler websearch search "cloudflare workers"
npx wrangler websearch search "cloudflare workers" --limit 5
npx wrangler websearch search "cloudflare workers" --json
--limit is optional (defaults to 10, capped at 20). --json prints the raw response; without it the results render as a pretty table.
#13610 cbb39bd Thanks @petebacondarwin! - Add support for agent_memory bindings
Agent Memory bindings allow Workers to connect to Cloudflare's Agent Memory service for storing and retrieving agent conversation state. This binding is remote-only, meaning it always connects to the Cloudflare API during wrangler dev rather than using a local simulation.
To configure an agent_memory binding, add the following to your wrangler.json:
{
"agent_memory": [
{
"binding": "MY_MEMORY",
"namespace": "my-namespace"
}
]
}
Wrangler will automatically provision the namespace during deployment if it does not already exist. Type generation via wrangler types is also supported.
This change also adds the agent-memory:write OAuth scope to Wrangler's default login scopes, so wrangler login can request the permissions needed to provision and manage Agent Memory namespaces.
#14087 e3c862a Thanks @edmundhung! - Rename pipeline field to stream in pipeline bindings configuration
The pipeline field inside pipelines bindings has been renamed to stream to align with the updated API wire format. The old pipeline field is still accepted but deprecated and will emit a warning.
Before:
// wrangler.json
{
"pipelines": [
{
"binding": "MY_PIPELINE",
"pipeline": "my-stream-name"
}
]
}
After:
// wrangler.json
{
"pipelines": [
{
"binding": "MY_PIPELINE",
"stream": "my-stream-name"
}
]
}
#14079 972d13d Thanks @edmundhung! - Add JSON output to /cdn-cgi/handler/scheduled
The /cdn-cgi/handler/scheduled endpoint now accepts ?format=json to return the scheduled handler result as JSON, including whether the handler called controller.noRetry(). Requests without format=json still return the existing text outcome for backward compatibility.
#14106 7bb5c7a Thanks @dario-piotrowicz! - Add timeout to browser-rendering browser launch to prevent infinite hangs
The browser-rendering plugin's launchBrowser() function now passes a 5-minute timeout to waitForLineOutput() when waiting for Chrome to print its DevTools WebSocket URL. Previously, if Chrome failed to start or crashed before printing the URL, the promise would hang forever. This could cause CI pipelines and local dev sessions to get stuck indefinitely.
#14087 e3c862a Thanks @edmundhung! - Update dependencies of "miniflare", "wrangler"
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20260526.1 | 1.20260527.1 |
#14076 97d7d81 Thanks @dependabot! - Update dependencies of "miniflare", "wrangler"
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20260527.1 | 1.20260528.1 |
#14100 c647ccc Thanks @dependabot! - Update dependencies of "miniflare", "wrangler"
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20260528.1 | 1.20260529.1 |
#14087 e3c862a Thanks @edmundhung! - Fix wrangler dev crash under Yarn PnP when the worker emits a structured log or the inspector forwards a stack trace.
getFreshSourceMapSupport was unconditionally indexing require.cache, but when miniflare is imported from ESM under Yarn PnP, Node's ESM->CJS bridge (loadCJSModule in node:internal/modules/esm/translators) hands the wrapped CJS module a re-invented require that only carries .resolve and .main, with no .cache. Fall back to createRequire(__filename) in that case so the fresh-load cache-swap keeps working.
The following dependency versions have been updated:
#14003 c1fd2fd Thanks @dependabot! - Update dependencies of "miniflare", "wrangler"
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20260521.1 | 1.20260526.1 |
#14011 420e457 Thanks @petebacondarwin! - Warn when a remote-bindings request is blocked by Cloudflare Access
When wrangler dev is used with remote bindings and a request from the local remote-bindings proxy client to the remote workers.dev proxy server is blocked by Cloudflare Access (HTTP 403 with the Cloudflare Access block page), Wrangler now:
CLOUDFLARE_ACCESS_CLIENT_ID / CLOUDFLARE_ACCESS_CLIENT_SECRET (Service Token credentials) or run cloudflared access login to authenticate.InferenceUpstreamError from env.AI.run()) and any browser response piped back via a service binding .fetch().Previously the 403 was returned to user code with the full Access HTML, which both drowned out other logs and made it hard to tell that the failure was due to Cloudflare Access on workers.dev rather than a problem in the binding itself or the deployed proxy server. The detection runs inside the proxy client worker (which only ever talks to the remote-bindings proxy URL), so it does not trigger false positives on user-worker 403s.
The following dependency versions have been updated:
#13993 0733688 Thanks @dependabot! - Update dependencies of "miniflare", "wrangler"
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20260520.1 | 1.20260521.1 |
#13999 30657e1 Thanks @edmundhung! - Fix TCP requests failing when outboundService is configured
Workers using outboundService can now open TCP connections with cloudflare:sockets. Previously, TCP requests could throw an error when a custom outbound service was configured.
GHSA-58qx-3vcg-4xpx / CVE-2026-45736 reports an uninitialized-memory disclosure in ws@<8.20.1 when a TypedArray is passed as the reason argument to We…
#13978 fa1f61f Thanks @sassyconsultingllc! - Bump ws from 8.18.0 to 8.20.1 to address GHSA-58qx-3vcg-4xpx
GHSA-58qx-3vcg-4xpx / CVE-2026-45736 reports an uninitialized-memory disclosure in ws@<8.20.1 when a TypedArray is passed as the reason argument to WebSocket.close(). The fix shipped in ws@8.20.1 on 2026-05-12. This change bumps the workspace catalog entry so that miniflare, wrangler, and @cloudflare/vite-plugin all pick up the patched release.
#13977 2679e05 Thanks @dependabot! - Update dependencies of "miniflare", "wrangler"
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20260518.1 | 1.20260519.1 |
#13984 7e40d98 Thanks @dependabot! - Update dependencies of "miniflare", "wrangler"
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20260519.1 | 1.20260520.1 |
#13912 d803737 Thanks @petebacondarwin! - Fix /cdn-cgi/* host validation incorrectly accepting subdomains of exact configured routes
Miniflare's /cdn-cgi/* host/origin validator was treating exact configured routes the same as wildcard configured routes, so a request whose Host or Origin hostname was a subdomain of an exact route (e.g. sub.my-custom-site.com for a my-custom-site.com/* route) was incorrectly accepted. Exact configured routes and the configured upstream hostname are now required to match the request hostname exactly. Subdomain matching is only applied to wildcard routes such as *.example.com/*. Localhost hostnames continue to be allowed as before.
This affects wrangler dev and local development through @cloudflare/vite-plugin, both of which use Miniflare under the hood.
#13971 59cd880 Thanks @petebacondarwin! - Improve error diagnostics in the Browser Run binding worker
When the local Browser Run binding failed to reach an upstream — for example when Chrome failed to launch and miniflare's loopback /browser/launch endpoint returned a 500 with a stack-trace text body — the binding worker would call response.json() on the non-JSON body and throw an opaque SyntaxError: Unexpected token X, "..." is not valid JSON. The actual upstream error message (e.g. Chrome readiness probe at ... timed out after 5000ms) was discarded.
The binding worker now reads the response body as text first, surfaces the HTTP status and body content in the thrown error, and chains the original SyntaxError via cause when the body was a 2xx response that didn't parse as JSON. This makes both local-dev failures and CI test flakes self-diagnosing.
#13980 e8c2031 Thanks @petebacondarwin! - Recover from corrupted @puppeteer/browsers cache when launching a Browser Run session
When Miniflare's local Browser Run binding launches Chrome, it calls @puppeteer/browsers' install() to ensure the binary is present. If a previous install() was interrupted mid-extraction (test timeout, process kill, antivirus quarantine), the cache directory can be left partially populated — the folder exists but the executable inside it is missing. install() then throws The browser folder (...) exists but the executable (...) is missing on every subsequent call within the same process and the entire test session, breaking every later Browser Run operation until the cache is manually cleared.
launchBrowser now catches that specific error, removes the corrupted cache directory, and retries install() once. If the corruption persists after cleanup, the original error is rethrown with a clearer message.
This complements #13971, which surfaced the original error from inside the binding worker. With that diagnostic in place and this self-healing layer, the previously-intermittent "browser folder exists but executable missing" failure mode should no longer fail an entire CI run.
The following dependency versions have been updated:
b27eb18 Thanks @benjamincburns! - Bumped miniflare deps acorn to 8.16.0 and acorn-walk to 8.3.5 to add support for the using and await using keywords when miniflare parses scripts.#13948 b25dc0d Thanks @dependabot! - Update dependencies of "miniflare", "wrangler"
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20260515.1 | 1.20260518.1 |
#13932 ebf4b24 Thanks @zebp! - Fix local Workflow startup when compatibility flags include experimental
Miniflare now deduplicates compatibility flags for the internal Workflow engine service. This prevents wrangler dev from failing with Compatibility flag specified multiple times: experimental when the user's Worker already enables that flag.
The following dependency versions have been updated:
#13926 19ed49a Thanks @dependabot! - Update dependencies of "miniflare", "wrangler"
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20260511.1 | 1.20260515.1 |
The following dependency versions have been updated:
#13894 58b4403 Thanks @dependabot! - Update dependencies of "miniflare", "wrangler"
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20260508.1 | 1.20260511.1 |
#13646 f781a2b Thanks @emily-shen! - Propagate cf-trace-id header on remote binding proxy requests
When the CF_TRACE_ID environment variable is set, its value is now forwarded as a cf-trace-id header on outgoing remote binding proxy requests. This makes it easier to correlate traces when debugging remote bindings in local development.
The following dependency versions have been updated:
5d936c5 Thanks @penalosa! - Support workerd autogates via the MINIFLARE_WORKERD_AUTOGATES environment variable.#13866 4e44ce6 Thanks @dependabot! - Update dependencies of "miniflare", "wrangler"
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20260507.1 | 1.20260508.1 |
The miniflare hosted images mock previously returned bare variant names (e.g. "public") in the variants field of ImageMetadata. In production, this fi
#13348 5cf6f81 Thanks @mglewis! - Improve variant URLs returned by the hosted images mock for local development
The miniflare hosted images mock previously returned bare variant names (e.g. "public") in the variants field of ImageMetadata. In production, this field contains full delivery URLs. The bare names were not usable as image sources, causing applications that render images from variant URLs to fail during local development.
Variant URLs now point to a new local delivery endpoint at /cdn-cgi/imagedelivery/<image_id>/<variant> which serves image bytes directly from the local KV store with content-type detection via Sharp.
The send_email binding's MessageBuilder now accepts EmailAddress objects for to, cc, and bcc in addition to plain strings. You can mix named and plain
#13836 039bada Thanks @Skye-31! - Support named recipients in the Email Sending API MessageBuilder
The send_email binding's MessageBuilder now accepts EmailAddress objects for to, cc, and bcc in addition to plain strings. You can mix named and plain addresses in the same array:
await env.SEND_EMAIL.send({
from: "sender@example.com",
to: [
"plain@example.com",
'"Name" <address@example.com>',
{ name: "Jane Doe", email: "jane@example.com" },
],
cc: [{ name: "CC Person", email: "cc@example.com" }],
subject: "Hello",
text: "...",
});
Additionally, addresses in "Name" <address> format are now correctly parsed when checking allowed_destination_addresses and allowed_sender_addresses restrictions.
#13776 1a54ac5 Thanks @petebacondarwin! - Default the workerd runtime subprocess to TZ=UTC to match the production Cloudflare runtime
Previously, Miniflare inherited the host machine's timezone, so Date and Intl APIs inside a Worker observed the developer's local timezone during local development but UTC in production. This caused dev/prod drift that was hard to debug.
Miniflare now sets TZ=UTC on the spawned workerd subprocess by default. A new unsafeRuntimeEnv option (a Record<string, string>) is available on the Miniflare constructor for advanced cases that need to override the default — for example, to test timezone-dependent behaviour:
new Miniflare({
modules: true,
script: "...",
unsafeRuntimeEnv: { TZ: "Europe/London" },
});
#13829 2284f20 Thanks @dependabot! - Update dependencies of "miniflare", "wrangler"
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20260504.1 | 1.20260506.1 |
#13841 332f527 Thanks @dependabot! - Update dependencies of "miniflare", "wrangler"
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20260506.1 | 1.20260507.1 |
The following dependency versions have been updated:
#13765 3020214 Thanks @dependabot! - Update dependencies of "miniflare", "wrangler"
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20260430.1 | 1.20260501.1 |
#13800 0099265 Thanks @dependabot! - Update dependencies of "miniflare", "wrangler"
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20260501.1 | 1.20260504.1 |
#13737 bb27219 Thanks @ruifigueira! - Fix race condition that broke Browser Run on Windows when Chrome had not yet started accepting connections
When Miniflare launched Chrome for Browser Run bindings, it returned the WebSocket endpoint as soon as Chrome printed its DevTools listening on ws://... banner. On Windows the underlying listening socket is occasionally not yet accepting connections at that point, causing the first request from workerd to Chrome to fail with ConnectEx (#1225) The remote computer refused the network connection. and the user worker to receive an error response from /v1/acquire.
Miniflare now probes Chrome's /json/version HTTP endpoint with retry/backoff after the banner is logged, only declaring the browser ready once the socket actually accepts connections. As an additional safety net, the browser binding worker also retries transient ConnectEx/WSARecv failures when establishing connections to Chrome.
#13767 12fb5db Thanks @edmundhung! - Fix local explorer startup in Yarn Plug'n'Play projects by copying the explorer UI assets to a real temporary directory before registering the workerd disk service.
Wrangler no longer supports Node.js 20.x, as it reached end-of-life on 2026-04-30. The minimum supported Node.js version is now 22.0.0. See https://gi
#13726 b5ac54b Thanks @penalosa! - Hard fail on Node.js < 22
Wrangler no longer supports Node.js 20.x, as it reached end-of-life on 2026-04-30. The minimum supported Node.js version is now 22.0.0. See https://github.com/nodejs/release?tab=readme-ov-file#end-of-life-releases.
#13390 0bf64a7 Thanks @Ltadrian! - Fix Hyperdrive binding issue where some customers are unable to connect to local databases using wrangler dev
#13565 b04eedf Thanks @vaishnav-mk! - Add restart from step support for local Workflows development
Workflow instances can now be restarted from a specific step in local development. When restarting from a step, all earlier steps preserve their cached results and replay instantly, while the target step and everything after it re-execute.
The WorkflowInstance.restart() method now accepts an optional { from: { name, count?, type? } } parameter to specify which step to restart from.
#13618 c07d0cb Thanks @jamesopstad! - Support V2 protocol for module fallback service
When the new_module_registry compatibility flag is set, requests sent to unsafeModuleFallbackService() use a different protocol. Miniflare now supports both protocols and exports a parseModuleFallbackRequest() utility to ease handling.
#13732 22e1a61 Thanks @dependabot! - Update dependencies of "miniflare", "wrangler"
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20260426.1 | 1.20260429.1 |
#13754 00523c8 Thanks @dependabot! - Update dependencies of "miniflare", "wrangler"
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20260429.1 | 1.20260430.1 |
#13723 e653edf Thanks @edmundhung! - Expose send_email bindings from getPlatformProxy()
Projects developing in Node can now access send_email bindings from the platform proxy. This supports the plain-object MessageBuilder API locally, so calls like env.EMAIL.send({ from, to, subject, text }) no longer fail because the binding is missing.
#12514 e1eff94 Thanks @ascorbic! - fix: normalise typed array subclasses in devalue serialization
Node.js Buffer extends Uint8Array but isn't available in all runtimes. When a Buffer was passed through the proxy serialization bridge (e.g. as a D1 bind parameter via getPlatformProxy()), the reviver would fail because "Buffer" isn't in the allowed constructor list and may not exist on globalThis in workerd.
The reducer now normalises subclass constructor names to the nearest standard typed array parent before serialization, matching structured clone behaviour.
#13116 e539008 Thanks @dario-piotrowicz! - Gracefully handle a missing assets directory by starting with zero assets
Previously, configuring Miniflare with an assets.directory that did not exist on disk would cause the asset services to fail to start. This is a common situation during wrangler dev when the assets directory is a build output that hasn't been generated yet.
Now, when the configured assets directory does not exist, Miniflare creates an empty temporary directory and starts the asset services with zero assets. Once the real directory is created and setOptions() is called (e.g. triggered by the file watcher), Miniflare reloads and begins serving the actual assets.
#13363 6457fb3 Thanks @courtney-sims! - Prepares router-worker for a more gradual rollout by refactoring and separating out the invocation from the business logic. In the future, this will provide space for us to route requests to new versions of router-worker based on their plan, but should make no functional difference today.
Flagship bindings now always access the remote Flagship service during local development, matching the behavior of AI bindings. Previously, Flagship s
#13599 21b87b2 Thanks @Ltadrian! - Add extended sslmode support for Hyperdrive local dev. This adds support for sslmodes verify-full / verify-ca for Postgres and VERIFY_IDENTITY / VERIFY_CA for MySQL
#13617 118027d Thanks @roerohan! - Force Flagship bindings to always use remote mode in local dev
Flagship bindings now always access the remote Flagship service during local development, matching the behavior of AI bindings. Previously, Flagship supported both local and remote modes, but the local stub only returned default values, providing no real functionality and creating a dual source of truth for flag evaluations.
The remote config field is retained for backward compatibility but only controls whether a warning is displayed. Setting remote: true suppresses the warning that Flagship bindings always access remote resources and may incur usage charges in local dev.
#13696 62e9f2a Thanks @dependabot! - Update dependencies of "miniflare", "wrangler"
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20260424.1 | 1.20260426.1 |
#13652 033d6ec Thanks @emily-shen! - fix: allow multiple workers with browser bindings in dev
You can now run multiple workers with multiple browser bindings in miniflare. Previously, this would crash with kj/table.c++:49: failed: inserted row already exists in table.
#13649 ae8eae3 Thanks @petebacondarwin! - Fix service binding and tail consumer props being dropped between workers in different local dev instances
When a service binding or tail consumer configured with props targeted a worker running in a separate wrangler dev instance (via the dev registry), the props were silently dropped and the remote entrypoint saw an empty ctx.props. Props are now forwarded correctly across the dev registry boundary, matching the behavior users get when all workers run in a single instance.
// wrangler.json
{
"services": [
{
"binding": "AUTH",
"service": "auth-worker", // may be in a separate `wrangler dev` process
"entrypoint": "SessionEntry",
"props": { "tenant": "acme" }
}
]
}
The target worker's SessionEntry entrypoint now correctly receives { tenant: "acme" } on ctx.props regardless of which local dev instance it runs in.
#13668 ef24ff2 Thanks @for-the-kidz! - Fix TypeError: rules is not iterable in the router-worker when static_routing is configured without user_worker rules
The router-worker's static-routing include-rule evaluation passed config.static_routing.user_worker directly to the matcher, which iterates with for...of. When static_routing was set but user_worker was omitted, the matcher threw TypeError: rules is not iterable and failed the request. The adjacent asset_worker branch already falls back to [] in this case; the user_worker branch now does the same.
#13654 6d27479 Thanks @pombosilva! - fix: Preserve internal counter suffix on workflow step names in local explorer API
Stop stripping the -N suffix from step names in the API response so the UI can distinguish duplicate step names. The suffix is now stripped only visually in the UI.
Videos uploaded while in local mode are now served at /cdn-cgi/mf/stream/ /watch. The preview field in StreamVideo is now directly fetchable during de
#13234 7fc50c1 Thanks @natewong1313! - Support serving videos locally, add publicUrl option for stable stream preview URLs, and add caption upload support via ReadableStream
Videos uploaded while in local mode are now served at /cdn-cgi/mf/stream/<video-id>/watch. The preview field in StreamVideo is now directly fetchable during development.
A new publicUrl option on MiniflareOptions allows callers (e.g. Wrangler, the Vite plugin) to advertise a stable, externally-reachable URL for the Miniflare instance. When set, Stream preview URLs use this value instead of the runtime entry URL, so they remain valid across runtime restarts and port changes. The same value is also exposed as a mutable miniflare.publicUrl property.
The helper functions buildPublicUrl and getLocallyAccessibleHost are now exported from miniflare, enabling consumers to construct client-reachable URLs that correctly handle IPv6 addresses (bracketing) and wildcard listen addresses (0.0.0.0, ::, * → 127.0.0.1).
Caption uploads via ReadableStream are now supported in local mode. They no longer throw a "not supported in local mode" error.
#13633 3494842 Thanks @dependabot! - Update dependencies of "miniflare", "wrangler"
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20260421.1 | 1.20260422.1 |
#13645 7d728fb Thanks @dependabot! - Update dependencies of "miniflare", "wrangler"
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20260422.1 | 1.20260423.1 |
#13657 df9319d Thanks @dependabot! - Update dependencies of "miniflare", "wrangler"
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20260423.1 | 1.20260424.1 |
#13659 3ceeec3 Thanks @petebacondarwin! - Make the dev registry watcher reliable on Windows
The filesystem-based dev registry used chokidar with default settings, which on Windows backs onto fs.watch (ReadDirectoryChangesW). That API is known to drop or delay create events for files added shortly after the watcher attaches, which is especially common under CI virtualization. When this happened, a process that had attached its watcher before another process registered its worker would never be notified of the new entry until the next 30-second heartbeat — long enough to time out cross-process service-binding calls.
Switch to chokidar's polling mode on Windows so the dev registry observes cross-process worker registrations reliably. The registry directory is small and a 100ms poll interval has negligible cost. Non-Windows platforms continue to use the more efficient native filesystem-event backend.
#13560 7567ef7 Thanks @vaishnav-mk! - Preserve NonRetryableError message and name when the workflows_preserve_non_retryable_error_message compatibility flag is enabled, instead of replacing it with a generic error message.
#13644 377715d Thanks @MattieTK! - Update @clack/core and @clack/prompts to v1.2.0
Bumps the bundled @clack/core dependency used internally by @cloudflare/cli from 0.3.x to 1.2.0, and the @clack/prompts dependency in create-cloudflare from 0.6.x to 1.2.0. Clack v1 includes a number of API changes, but no user-facing prompt behaviour changes are expected.
The following dependency versions have been updated:
#13615 8fec8b8 Thanks @dependabot! - Update dependencies of "miniflare", "wrangler"
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20260420.1 | 1.20260421.1 |
#13613 2f3d7b9 Thanks @dario-piotrowicz! - Fix sourcemap warnings caused by references to files outside the package boundary
miniflare's bundled sourcemap contained sources entries pointing into node_modules dependencies (zod, capnp-es, chokidar, etc.), which produced dozens of warnings in pnpm monorepos when tools like Vite or Vitest validated the sourcemaps at runtime. The build now inlines sourcesContent and patches any null entries left by upstream dependencies that don't publish their original source files
You can now configure Artifacts bindings in your wrangler configuration:
#13326 4a9ba90 Thanks @mattzcarey! - Add Artifacts binding support to wrangler
You can now configure Artifacts bindings in your wrangler configuration:
// wrangler.jsonc
{
"artifacts": [{ "binding": "MY_ARTIFACTS", "namespace": "default" }]
}
Type generation produces the correct Artifacts type reference from the workerd type definitions:
interface Env {
MY_ARTIFACTS: Artifacts;
}
#12600 50bf819 Thanks @penalosa! - Use workerd's debug port to power cross-process service bindings, Durable Objects, and tail workers via the dev registry. This enables Durable Object RPC via the dev registry, and is an overall stability improvement.
#13515 b35617b Thanks @petebacondarwin! - fix: close all open handles on dispose to prevent process hangs
Several resources were not being properly cleaned up during Miniflare.dispose(), which could leave the Node.js event loop alive and cause processes (particularly tests using node --test) to hang instead of exiting cleanly:
Pool used to dispatch fetch requests to the workerd runtime was not closed. Lingering TCP sockets from this pool could keep the event loop alive indefinitely.WebSocketServer instances for live reload and WebSocket proxying were never closed, leaving connected clients' sockets open.InspectorProxy was not closing its runtime WebSocket connection, relying on process death to break the connection.HyperdriveProxyController.dispose() had a missing return in a .map() callback, causing Promise.allSettled to resolve immediately without waiting for net.Server instances to close.ProxyClientBridge was not clearing its finalization batch setTimeout during disposal.InspectorProxyController.dispose() was not calling server.closeAllConnections() before server.close(), so active HTTP keep-alive or WebSocket connections could prevent the close callback from firing.#13557 8ca78bb Thanks @dependabot! - Update dependencies of "miniflare", "wrangler"
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20260415.1 | 1.20260416.2 |
#13579 b6e1351 Thanks @dependabot! - Update dependencies of "miniflare", "wrangler"
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20260416.2 | 1.20260417.1 |
#13604 d8314c6 Thanks @petebacondarwin! - Update dependencies of "miniflare", "wrangler"
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20260417.1 | 1.20260420.1 |
#12913 7f50300 Thanks @Sigmabrogz! - fix(miniflare): use 127.0.0.1 for internal loopback when localhost is configured
When localhost is configured as the host, Node.js may bind to [::1] (IPv6) while workerd resolves localhost to 127.0.0.1 (IPv4) first. This mismatch causes connection refused errors and 100% CPU spins.
This fix ensures the internal loopback communication between Node.js and workerd always uses 127.0.0.1 when localhost is configured, while preserving the user-facing URL as localhost.
#13470 4fda685 Thanks @penalosa! - fix: prevent remote binding sessions from expiring during long-running dev sessions
Preview tokens for remote bindings expire after one hour. Previously, the first request after expiry would fail before a refresh was triggered. This change proactively refreshes the token at 50 minutes so no request ever sees an expired session.
The reactive recovery path is also improved: error code: 1031 responses (returned by bindings such as Workers AI when their session times out) now correctly trigger a refresh, where previously only Invalid Workers Preview configuration HTML responses did.
Auth credentials are now resolved lazily when a remote proxy session starts rather than at bundle-complete time. This means that if your OAuth access token has been refreshed since wrangler dev started, the new token is used rather than the one captured at startup.
#13586 be5e6a0 Thanks @petebacondarwin! - Fix resource leaks during config updates
Two follow-up fixes to the dispose cleanup in #13515:
runtimeDispatcher behavior. Previously, every config update unconditionally tore down and rebuilt the connection pool, which could cause brief request failures if a registry push was in-flight.InspectorProxy instances before replacing them during updateConnection(). Previously, stale proxies were silently discarded, leaking their runtime WebSocket connections and 10-second keepalive interval timers.#13577 e456952 Thanks @connyay! - Return EmailSendResult from the send_email binding's send() in local mode
The binding's send() used to resolve to undefined. It now returns { messageId: string }, the same shape as the public SendEmail type in production. Workers that read the return value (for logging, or to pass the id downstream) no longer get undefined under miniflare.
Both branches synthesize an id in the shape production returns — <{36 alphanumeric chars}@{sender domain}>, angle brackets included — using the envelope from for the EmailMessage path and the builder's from for the MessageBuilder path. Production synthesizes its own id rather than echoing anything submitted, so miniflare does the same.
#13516 4eb1da9 Thanks @jonnyparris! - Rename "Browser Rendering" to "Browser Run" in all user-facing strings, error messages, and CLI output.
#13557 8ca78bb Thanks @dependabot! - Rename Flags type to Flagship to match the upstream rename in @cloudflare/workers-types
The Flags type was renamed to Flagship in @cloudflare/workers-types. This updates the import and the return type of getFlagshipBinding accordingly.
#11849 266c418 Thanks @43081j! - Removed unused devDependencies from miniflare package.
Previously, sending a POST or PUT request that received a non-2xx response (e.g. 401, 400, 403) would throw a TypeError: fetch failed error. This was
#13354 854d66c Thanks @courtney-sims! - Prepares asset-worker for a more gradual rollout by refactoring and separating out the invocation from the business logic. In the future, this will provide space for us to route requests to new versions of asset-worker based on their plan, but should make no functional difference today.
#13450 6f63eaa Thanks @petebacondarwin! - Fix POST/PUT requests with non-2xx responses throwing "fetch failed"
Previously, sending a POST or PUT request that received a non-2xx response (e.g. 401, 400, 403) would throw a TypeError: fetch failed error. This was caused by an undici bug where isTraversableNavigable() incorrectly returned true, causing the 401 credential-retry block to execute in Node.js and fail on stream-backed request bodies. This has been fixed upstream in undici v7.24.8, so we've bumped our dependency and removed the previous pnpm patch workaround.
#13447 aef9825 Thanks @dependabot! - Update dependencies of "miniflare", "wrangler"
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20260410.1 | 1.20260413.1 |
#13475 eaaa728 Thanks @dependabot! - Update dependencies of "miniflare", "wrangler"
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20260413.1 | 1.20260415.1 |
#13472 58292f6 Thanks @roerohan! - Fix wrangler dev crash when using a Flagship binding with remote: true
In remote mode, the flagship binding is backed by a generic proxy worker that only has a default export. The plugin was requesting a named entrypoint "FlagshipBinding" which doesn't exist on it, causing workerd to reject the binding at startup. The named entrypoint is now omitted in remote mode so workerd routes to the default export, which correctly proxies all RPC calls to the remote Flagship service.
#13386 5e5bbc1 Thanks @mksglu! - Make startup network requests non-blocking on slow connections
Wrangler makes network requests during startup (npm update check, request.cf data fetch) that previously blocked the CLI indefinitely on slow or degraded connections (airplane wifi, trains), causing 10+ second delays.
update-check library's auth-retry path.request.cf fetch: The fetch to workers.cloudflare.com/cf.json now uses AbortSignal.timeout(3000), falling back to cached/default data on timeout.#13476 d5ff5a4 Thanks @roerohan! - Fix wrangler dev crash when using a Stream binding with remote: true
In remote mode, the Stream binding is backed by a generic proxy worker that only has a default export. The plugin was requesting a named entrypoint "StreamBinding" which doesn't exist on it, causing workerd to reject the binding at startup. The named entrypoint is now omitted in remote mode so workerd routes to the default export, which correctly proxies all RPC calls to the remote Stream service.
#13426 89c7829 Thanks @edmundhung! - Reject non-local /cdn-cgi/* requests in Miniflare
Miniflare now validates Host and Origin on /cdn-cgi/* requests before request rewriting. Requests are still allowed for localhost, configured route hostnames, and the configured upstream hostname, but non-local hostnames can no longer reach internal development endpoints such as platform-proxy, handler routes, live reload, and the local explorer.
Adds end-to-end support for the Flagship feature flag binding, which allows Workers to evaluate feature flags from Cloudflare's Flagship service. Conf
#13139 79fd529 Thanks @roerohan! - feat: add Flagship feature flag binding support
Adds end-to-end support for the Flagship feature flag binding, which allows Workers to evaluate feature flags from Cloudflare's Flagship service. Configure it in wrangler.json with a flagship array containing binding and app_id entries. In local dev, the binding returns default values for all flag evaluations; use "remote": true in the binding to evaluate flags against the live Flagship service.
#13392 2589395 Thanks @emily-shen! - Add telemetry to local REST API
The local REST API (used by the local explorer) now collects anonymous usage telemetry. This respects any existing telemetry preferences, which can be disabled by running the command wrangler telemetry disable.
This only applies when the dev session is started via Wrangler, and not via the Vite plugin or standalone Miniflare.
No actual data values, keys, query contents, or resource IDs are collected.
Event schema:
{
"event": "localapi.<route>.<method>", // e.g. localapi.kv.keys.get
"deviceId": "<uuid>",
"timestamp": 1234567890,
"properties": {
"userAgent": "Mozilla/5.0 ...",
// Only for localapi.local.workers.get:
"workerCount": 2,
"kvCount": 3,
"d1Count": 1,
"r2Count": 0,
"doCount": 1,
"workflowsCount": 0
}
}
Note: the Local Explorer and corresponding local REST API is still an experimental feature.
#13393 c50cb5b Thanks @dependabot! - Update dependencies of "miniflare", "wrangler"
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20260409.1 | 1.20260410.1 |
#13335 5eff8c1 Thanks @KennethRuan! - Return metadata in queue broker response
The queue broker's /message and /batch endpoints now return a JSON response body containing queue metrics (backlogCount, backlogBytes, oldestMessageTimestamp) instead of an empty response. A new GET /metrics endpoint is also added to support the metrics() API.
Note: The local explorer is a WIP experimental feature.
#13133 42c7ef0 Thanks @emily-shen! - explorer: list DO instances with name where possible
Note: The local explorer is a WIP experimental feature.
#13336 a42e0e8 Thanks @emily-shen! - local explorer: fix handling on resources that are bound to multiple workers
Note the local explorer is a experimental feature still.
#13337 c510494 Thanks @dependabot! - Update dependencies of "miniflare", "wrangler"
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20260405.1 | 1.20260408.1 |
#13362 8b71eca Thanks @dependabot! - Update dependencies of "miniflare", "wrangler"
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20260408.1 | 1.20260409.1 |
The local explorer is supported by a REST API served from the worker's local address. It can be accessed independently of the UI, (e.g. by an AI agent
#13240 a3e3b57 Thanks @emily-shen! - local explorer: serve the local explorer's OpenAPI spec at /cdn-cgi/explorer/api
The local explorer is supported by a REST API served from the worker's local address. It can be accessed independently of the UI, (e.g. by an AI agent) and is thus documented at this endpoint.
#13314 7a60d4b Thanks @Ltadrian! - Fix hyperdrive local dev binding tls configuration bug
#13241 7d318e1 Thanks @dependabot! - Update dependencies of "miniflare", "wrangler"
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20260401.1 | 1.20260402.1 |
#13305 fa6d84f Thanks @dependabot! - Update dependencies of "miniflare", "wrangler"
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20260402.1 | 1.20260405.1 |
#13241 7d318e1 Thanks @dependabot! - Update Images binding local mock to use chainable handle pattern
hosted.image(imageId) now returns a handle with details(), bytes(), update(), and delete() methods, aligning with the updated workerd API (https://github.com/cloudflare/workerd/pull/6288).
The supportedCompatibilityDate export is now deprecated. Instead of relying on the workerd-derived compatibility date, callers should just use today's…
#13051 d5bffde Thanks @dario-piotrowicz! - Deprecate supportedCompatibilityDate export
The supportedCompatibilityDate export is now deprecated. Instead of relying on the workerd-derived compatibility date, callers should just use today's date directly, e.g. new Date().toISOString().slice(0, 10).
#13011 b9b7e9d Thanks @ruifigueira! - Add experimental headful browser rendering support for local development
Experimental: This feature may be removed or changed without notice.
When developing locally with the Browser Rendering API, you can enable headful (visible) mode via the X_BROWSER_HEADFUL environment variable to see the browser while debugging:
X_BROWSER_HEADFUL=true wrangler dev
X_BROWSER_HEADFUL=true vite dev
Note: when using @cloudflare/playwright, two Chrome windows may appear — the initial blank page and the one created by browser.newPage(). This is expected behavior due to how Playwright handles browser contexts via CDP.
#12992 48d83ca Thanks @RiscadoA! - Add vpc_networks binding support for routing Worker traffic through a Cloudflare Tunnel or network.
{
"vpc_networks": [
// Route through a specific Cloudflare Tunnel
{ "binding": "MY_FIRST_VPC", "tunnel_id": "<tunnel-id>" },
// Route through the Cloudflare One mesh network
{ "binding": "MY_SECOND_VPC", "network_id": "cf1:network" }
]
}
#13155 5d29055 Thanks @dependabot! - Update dependencies of "miniflare", "wrangler"
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20260329.1 | 1.20260331.1 |
#13162 fb67a18 Thanks @dependabot! - Update dependencies of "miniflare", "wrangler"
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20260331.1 | 1.20260401.1 |
#13238 b2f53ea Thanks @guybedford! - Fix source phase imports parsing in Miniflare
Miniflare now uses the acorn-import-phases plugin to parse import source syntax when analyzing module dependencies. This fixes ERR_MODULE_PARSE errors when running Workers that use source phase imports for WebAssembly modules in local development.
The local browser rendering binding now implements the full set of devtools endpoints, matching the remote Browser Rendering API:
#13025 9eff028 Thanks @ruifigueira! - Add missing devtools endpoints to browser rendering local binding.
The local browser rendering binding now implements the full set of devtools endpoints, matching the remote Browser Rendering API:
GET /v1/limits — returns local concurrency defaultsGET /v1/history — returns empty array (no persistence in local dev)GET /v1/devtools/session - list and inspect active sessionsGET /v1/devtools/session/:id — list and inspect active sessionGET /v1/devtools/browser/:id/json/version — Browser version metadata, includes webSocketDebuggerUrlGET /v1/devtools/browser/:id/json/list — A list of all available websocket targetsGET /v1/devtools/browser/:id/json — Alias for GET /v1/devtools/browser/:id/jsonGET /v1/devtools/browser/:id/json/protocol — The current devtools protocol, as JSON. Includes webSocketDebuggerUrl and devtoolsFrontendUrlPUT /v1/devtools/browser/:id/json/new — Opens a new tab. Responds with the websocket target data for the new tabGET /v1/devtools/browser/:id/json/activate/:target — Brings a page into the foreground (activate a tab)GET /v1/devtools/browser/:id/json/close/:target — Closes the target page identified by targetIdGET /v1/devtools/browser/:id/page/:target — WebSocket connection to a page targetGET /v1/devtools/browser/:id — WebSocket connection to a previously acquired browser sessionDELETE /v1/devtools/browser/:id — Closes a browser sessionPOST /v1/devtools/browser — Acquires a new sessionGET /v1/devtools/browser — Acquire a new session and connect via WebSocket in one step, returning cf-browser-session-id header#13086 d4c6158 Thanks @pombosilva! - Add Workflows support to the local explorer UI.
The local explorer (/cdn-cgi/explorer/) now includes a full Workflows dashboard for viewing and managing workflow instances during local development.
UI features:
#13111 f214760 Thanks @dependabot! - Update dependencies of "miniflare", "wrangler"
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20260317.1 | 1.20260329.1 |
#13078 9282493 Thanks @penalosa! - Fix noisy EBUSY errors on Windows when disposing Miniflare instances
On Windows, workerd may not release file handles immediately after disposal, causing EBUSY errors when Miniflare tries to remove its temporary directory during dispose(). Previously, this error propagated to the caller (e.g. vitest-pool-workers), producing repeated noisy error messages in test output. The cleanup is now best-effort — matching the existing exit hook behaviour — since the temporary directory lives in os.tmpdir() and will be cleaned up by the OS.
#13090 a532eea Thanks @edmundhung! - Remove LOCAL_EXPLORER_BASE_PATH and LOCAL_EXPLORER_API_PATH constants in favor of CorePaths.EXPLORER
These were redundant aliases introduced before CorePaths was centralized. All internal consumers now use CorePaths.EXPLORER directly.
Two new binding types for AI Search:
#13027 9fcdfca Thanks @G4brym! - feat: Add ai_search_namespaces and ai_search binding types
Two new binding types for AI Search:
ai_search_namespaces: Namespace binding — namespace is required and auto-provisioned at deploy time if it doesn't exist (like R2 buckets)ai_search: Single instance binding bound directly to a pre-existing instance in the default namespaceBoth are remote-only in local dev.
#13030 0386553 Thanks @natewong1313! - Add local mode support for Stream bindings
Miniflare and wrangler dev now support using Cloudflare Stream bindings locally.
Supported operations:
upload() — upload video via URLvideo(id).details(), .update(), .delete(), .generateToken()videos.list()captions.generate(), .list(), .delete()downloads.generate(), .get(), .delete()watermarks.generate(), .list(), .get(), .delete()The following are not yet supported in local mode and will throw:
createDirectUpload()FileFileData is persisted across restarts by default. You must set streamPersist: false in Miniflare options to disable persistence.
#12686 1faff35 Thanks @edmundhung! - Move internal proxy endpoint to reserved /cdn-cgi/ path
The internal HTTP endpoint used by getPlatformProxy has been moved to a reserved path. This is an internal change with no impact on the getPlatformProxy API.
#13080 f4ea4ac Thanks @penalosa! - fix: glob patterns for module rules no longer match double-extension filenames like foo.wasm.js
Previously, the globsToRegExps helper compiled glob patterns without a trailing $ anchor. This caused patterns like **/*.wasm to match any path containing .wasm as a substring — including filenames such as foo.wasm.js or main.wasm.test.ts.
When using @cloudflare/vitest-pool-workers with a wrangler.configPath, Wrangler's default CompiledWasm module rule (**/*.wasm) was silently applied to test files whose names contained .wasm, causing them to be loaded as WebAssembly binaries instead of JavaScript and failing at runtime.
The fix restores the $ end anchor in the compiled regex so that **/*.wasm only matches paths that literally end in .wasm, while the leading ^ remains absent to allow matching anywhere within an absolute path.
Local Chrome version upgraded to 126.0.6478.182
#11753 b8f3309 Thanks @ruifigueira! - Added the following improvements to local Browser Rendering binding in Miniflare:
#12986 5aaaab2 Thanks @petebacondarwin! - fix: allow mixed d1Databases records containing both string and object entries
Previously, passing a d1Databases config that mixed plain string values and object entries (e.g. { MY_DB: "db-name", OTHER_DB: { id: "...", remoteProxyConnectionString: ... } }) would cause Miniflare to throw an error. Both forms are now accepted and normalised correctly.
#12986 5aaaab2 Thanks @petebacondarwin! - fix: allow mixed kvNamespaces records containing both string and object entries
Previously, passing a kvNamespaces config that mixed plain string values and object entries (e.g. { MY_NS: "ns-name", OTHER_NS: { id: "...", remoteProxyConnectionString: ... } }) would cause Miniflare to throw an error. Both forms are now accepted and normalised correctly.
#12987 f8516dd Thanks @petebacondarwin! - fix: allow mixed pipelines records containing both string and object entries
Previously, passing a pipelines config that mixed plain string values and object entries (e.g. { MY_PIPELINE: "pipeline-name", OTHER_PIPELINE: { pipeline: "...", remoteProxyConnectionString: ... } }) would cause Miniflare to throw an error. Both forms are now accepted and normalised correctly.
#12952 9c9fe30 Thanks @petebacondarwin! - fix: allow mixed r2Buckets records containing both string and object entries
Previously, passing an r2Buckets config that mixed plain string values and object entries (e.g. { MY_BUCKET: "bucket-name", OTHER_BUCKET: { ... } }) would cause Miniflare to throw an error. Both forms are now accepted and normalised correctly.
#13015 6a6449e Thanks @petebacondarwin! - fix: disable undici Pool request timeouts for local dev
Miniflare's undici Pool instances were using the default headersTimeout and bodyTimeout of 300 seconds (5 minutes). Any request taking longer than that — streaming responses, large uploads, long-polling, or compute-heavy Workers — would be silently killed with a "request failed" error.
Setting both timeouts to 0 disables them entirely, which is the correct behaviour for a local development tool where there is no reason to enforce request timeouts.
When multiple workers share a dev registry, all their bindings were previously shown together in a single flat list. The explorer now shows a worker s
#12972 cb71403 Thanks @NuroDev! - Add worker filtering to the local explorer UI
When multiple workers share a dev registry, all their bindings were previously shown together in a single flat list. The explorer now shows a worker selector dropdown, letting you inspect each worker's bindings independently.
The selected worker is reflected in the URL as a ?worker= search param, so deep links work correctly. By default the explorer selects the worker that is hosting the dashboard itself.
#12888 3a1c149 Thanks @emily-shen! - Add R2 support to the local explorer.
The local explorer now supports the following:
Note: The local explorer is an experimental WIP feature that is now enabled by default. This can still be opt-ed out of by using X_LOCAL_EXPLORER=false to disable it.
#12848 ce48b77 Thanks @emily-shen! - Enable local explorer by default
This ungates the local explorer, a UI that lets you inspect the state of D1, DO and KV resources locally by visiting /cdn-cgi/explorer during local development.
Note: this feature is still experimental, and can be disabled by setting the env var X_LOCAL_EXPLORER=false.
#12881 8729f3d Thanks @pombosilva! - Workflow instances now support pause, resume, restart, and terminate in local dev.
const instance = await env.MY_WORKFLOW.create({
id: "my-instance",
});
await instance.pause(); // pauses after the current step completes
await instance.resume(); // resumes from where it left off
await instance.restart(); // restarts the workflow from the beginning
await instance.terminate(); // terminates the workflow immediately
#12960 3c988e2 Thanks @penalosa! - Exclude metadata.sqlite when listing Durable Object instances
An upcoming version of workerd stores per-namespace alarm metadata in a metadata.sqlite file alongside per-actor .sqlite files. The local explorer's DO object listing was treating this file as a Durable Object instance, inflating counts and breaking pagination. This file is now filtered out.
The following dependency versions have been updated:
#12927 c9b3184 Thanks @penalosa! - Bump undici from 7.18.2 to 7.24.4
#12875 13df6c7 Thanks @dependabot! - Update dependencies of "miniflare", "wrangler"
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20260312.1 | 1.20260316.1 |
#12935 df0d112 Thanks @dependabot! - Update dependencies of "miniflare", "wrangler"
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20260316.1 | 1.20260317.1 |
#12928 81ee98e Thanks @petebacondarwin! - Migrate chrome-devtools-patches deployment from Cloudflare Pages to Workers + Assets
The DevTools frontend is now deployed as a Cloudflare Workers + Assets project instead of a Cloudflare Pages project. This uses wrangler deploy for production deployments and wrangler versions upload for PR preview deployments.
The inspector proxy origin allowlists in both wrangler and miniflare have been updated to accept connections from the new workers.dev domain patterns, while retaining the legacy pages.dev patterns for backward compatibility.
If routes are set, Miniflare will alter the host and origin headers to match, causing the local explorer to mistakenly identify and block same-origin
#12869 ade0aed Thanks @emily-shen! - Local explorer: validate host and origin headers before Miniflare modifies them
If routes are set, Miniflare will alter the host and origin headers to match, causing the local explorer to mistakenly identify and block same-origin requests.
Note the local explorer is a WIP experimental feature.
The following dependency versions have been updated:
#12861 f7de0fd Thanks @dependabot! - Update dependencies of "miniflare", "wrangler"
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20260310.1 | 1.20260312.1 |
#12864 ecc7f79 Thanks @NuroDev! - Fix local explorer route matching to be more precise
Previously, the route matching used startsWith("/cdn-cgi/explorer") which would incorrectly match paths like /cdn-cgi/explorerfoo or /cdn-cgi/explorereeeeee, causing unexpected behavior. The route matching has been improved to only match:
/cdn-cgi/explorer (exact match)/cdn-cgi/explorer/ and any sub-paths (e.g., /cdn-cgi/explorer/api/*)Paths that merely start with /cdn-cgi/explorer but aren't actually the explorer (like /cdn-cgi/explorerfoo) will now correctly fall through to the user worker.
#12775 1dda1c8 Thanks @fhanau! - Add support for worker connect handler in miniflare
Devalue had denial of service vulnerabilities in devalue.parse. These are bundled dependencies so the fix is delivered via this patch.
#12826 de65c58 Thanks @gabivlj! - Enable container egress interception in local dev without the experimental compatibility flag
Container local development now always prepares the egress interceptor sidecar image needed for interceptOutboundHttp(). This makes container-to-Worker interception available by default in Wrangler, Miniflare, and the Cloudflare Vite plugin.
#12754 e4d9510 Thanks @emily-shen! - Add cross-process support to the local explorer
When running multiple miniflare processes, the local explorer will now be able to view and edit resources that are bound to workers in other miniflare instances.
#12790 5451a7f Thanks @petebacondarwin! - Bump hono to ^4.12.5 and devalue to ^5.6.3 to address security vulnerabilities
Hono had multiple advisories including arbitrary file access via serveStatic, JWT algorithm confusion, and XSS through ErrorBoundary. Devalue had denial of service vulnerabilities in devalue.parse. These are bundled dependencies so the fix is delivered via this patch.
#12795 82cc2a8 Thanks @dependabot! - Update dependencies of "miniflare", "wrangler"
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20260301.1 | 1.20260306.1 |
#12811 3c67c2a Thanks @dependabot! - Update dependencies of "miniflare", "wrangler"
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20260306.1 | 1.20260307.1 |
#12827 d645594 Thanks @dependabot! - Update dependencies of "miniflare", "wrangler"
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20260307.1 | 1.20260310.1 |
#12828 cb14820 Thanks @jamesopstad! - Update @hey-api/openapi-ts to ^0.94.0
#12786 a7c87d1 Thanks @emily-shen! - local explorer: validate origin and host headers
The local explorer is a WIP experimental feature.
The following dependency versions have been updated:
#12661 99037e3 Thanks @dependabot! - Update dependencies of "miniflare", "wrangler"
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20260302.0 | 1.20260303.0 |
#12680 295297a Thanks @dependabot! - Update dependencies of "miniflare", "wrangler"
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20260303.0 | 1.20260305.0 |
The following dependency versions have been updated:
#12582 c2ed7c2 Thanks @penalosa! - Internal refactor to use capnweb's native ReadableStream support to power remote Media and Dispatch Namespace bindings.
#12618 d920811 Thanks @dependabot! - Update dependencies of "miniflare", "wrangler"
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20260219.0 | 1.20260227.0 |
#12637 896734d Thanks @dependabot! - Update dependencies of "miniflare", "wrangler"
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20260227.0 | 1.20260302.0 |
#12602 58a4020 Thanks @anonrig! - Optimize filesystem operations by using Node.js's throwIfNoEntry: false option
This reduces the number of system calls made when checking for file existence by avoiding the overhead of throwing and catching errors for missing paths. This is an internal performance optimization with no user-visible behavioral changes.
This feature is experimental and requires adding the "experimental" compatibility flag to your Wrangler configuration.
#12649 35b2c56 Thanks @gabivlj! - Add experimental support for containers to workers communication with interceptOutboundHttp
This feature is experimental and requires adding the "experimental" compatibility flag to your Wrangler configuration.
#10153 5f7aaf2 Thanks @mglewis! - Add Hosted Images CRUD operations to Images binding.
This is an experimental API that only works locally for the moment.
#12622 bf9cb3d Thanks @LuisDuarte1! - Add configurable step limits for Workflows
You can now set a maximum number of steps for a Workflow instance via the limits.steps configuration in your Wrangler config. When a Workflow instance exceeds this limit, it will fail with an error indicating the limit was reached.
// wrangler.jsonc
{
"workflows": [
{
"binding": "MY_WORKFLOW",
"name": "my-workflow",
"class_name": "MyWorkflow",
"limits": {
"steps": 5000
}
}
]
}
The steps value must be an integer between 1 and 25,000. If not specified, the default limit of 10,000 steps is used. Step limits are also enforced in local development via wrangler dev.
#12698 209b396 Thanks @penalosa! - Update dependencies of "miniflare", "wrangler"
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20260305.0 | 1.20260226.1 |
| @cloudflare/workers-types | 4.20260305.0 | 4.20260226.1 |
#12691 596b8a0 Thanks @penalosa! - Remove temporary AI Search RPC workaround (no user-facing changes)
This allows developers to clear cached data during local development without restarting the Miniflare instance. Useful when working with Workers Sites
#12462 f239077 Thanks @petebacondarwin! - Add Miniflare#purgeCache() method to clear cache entries programmatically
This allows developers to clear cached data during local development without restarting the Miniflare instance. Useful when working with Workers Sites or any application that uses the Cache API.
const mf = new Miniflare({
/* options */
});
// Purge the default cache
await mf.purgeCache();
// Purge a specific named cache
await mf.purgeCache("my-named-cache");
#12574 527e4f5 Thanks @emily-shen! - Local explorer: add /query endpoint to introspect sqlite in DOs
This required adding a wrapper that extends user DO classes and adds in an extra method to access ctx.storage.sql. This shouldn't have any impact on user code, but is gated by the env var X_LOCAL_EXPLORER.
This is for an experimental WIP feature.
#12592 aaa7200 Thanks @dependabot! - Update dependencies of "miniflare", "wrangler"
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20260217.0 | 1.20260218.0 |
#12606 2f19a40 Thanks @dependabot! - Update dependencies of "miniflare", "wrangler"
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20260218.0 | 1.20260219.0 |
#12597 0b17117 Thanks @sdnts! - The maximum allowed delivery and retry delays for Queues is now 24 hours
This is part of an experimental, WIP feature.
#12546 43c462a Thanks @emily-shen! - Local explorer: add endpoints to list DO namespaces and objects
This is part of an experimental, WIP feature.
#12543 5a868a0 Thanks @G4brym! - Fix AI Search binding failing in local dev
Using AI Search bindings with wrangler dev would fail with "RPC stub points at a non-serializable type". AI Search bindings now work correctly in local development.
#12552 c58e81b Thanks @dependabot! - Update dependencies of "miniflare", "wrangler"
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20260212.0 | 1.20260213.0 |
#12568 33a9a8f Thanks @dependabot! - Update dependencies of "miniflare", "wrangler"
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20260213.0 | 1.20260214.0 |
#12576 8077c14 Thanks @dependabot! - Update dependencies of "miniflare", "wrangler"
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20260214.0 | 1.20260217.0 |
#12466 caf9b11 Thanks @petebacondarwin! - Add MINIFLARE_CACHE_DIR environment variable and smart cache directory detection
Miniflare now intelligently detects where to store its cf.json cache file:
MINIFLARE_CACHE_DIR env var if setnode_modules/.mf or .wrangler/cache)node_modules/.mf if node_modules exists.wrangler/cacheThis improves compatibility with Yarn PnP, pnpm, and other package managers that don't use traditional node_modules directories, without requiring any configuration.
The UI and list keys API now lets you search KV keys by prefix.
#12431 7aaa2a5 Thanks @emily-shen! - Add ability to search KV keys by prefix
The UI and list keys API now lets you search KV keys by prefix.
This is an experimental WIP feature.
#12541 f7fa326 Thanks @dependabot! - Update dependencies of "miniflare", "wrangler"
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20260210.0 | 1.20260212.0 |
#12025 d06ad09 Thanks @petebacondarwin! - Fix potential EBADF error when restarting workerd process
Previously, when the workerd process was restarted (e.g., via setOptions() or Vite server restart), the stdio pipes from the previous process were not explicitly destroyed. This could lead to EBADF (Bad File Descriptor) errors during spawn on some systems.
The Runtime#dispose() method now explicitly destroys all stdio streams (stdin, stdout, stderr, and the control pipe) before killing the process to ensure file descriptors are properly released.
You can now use environment variables to control how Miniflare handles the Request.cf object caching:
#12469 2d90127 Thanks @petebacondarwin! - Add environment variables to control cf.json fetching behavior
You can now use environment variables to control how Miniflare handles the Request.cf object caching:
CLOUDFLARE_CF_FETCH_ENABLED - Set to "false" to disable fetching entirely and use fallback data. No node_modules/.mf/cf.json file will be created. Defaults to "true".CLOUDFLARE_CF_FETCH_PATH - Set to a custom path to use a different location for caching the cf.json file instead of the default node_modules/.mf/cf.json.This is particularly useful for non-JavaScript projects (like Rust or Go Workers) that don't want a node_modules directory created automatically.
Example:
# Disable cf fetching for all projects
export CLOUDFLARE_CF_FETCH_ENABLED=false
npx wrangler dev
# Or use a custom cache location
export CLOUDFLARE_CF_FETCH_PATH=/tmp/.cf-cache.json
npx wrangler dev
#12391 ce9dc01 Thanks @emily-shen! - Serve the local explorer UI from Miniflare
This bundles the local explorer UI into Miniflare, and if enabled, Miniflare serves the UI at /cdn-cgi/explorer.
This is an experimental, WIP feature.
#12440 555b32a Thanks @dependabot! - Update dependencies of "miniflare", "wrangler"
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20260205.0 | 1.20260206.0 |
#12485 d636d6a Thanks @dependabot! - Update dependencies of "miniflare", "wrangler"
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20260206.0 | 1.20260207.0 |
#12502 bf8df0c Thanks @dependabot! - Update dependencies of "miniflare", "wrangler"
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20260207.0 | 1.20260210.0 |
The following APIs have been implemented:
#12267 83adb2c Thanks @NuroDev! - Implement local D1 API for experimental/WIP local resource explorer
The following APIs have been implemented:
GET /d1/database - Returns a list of D1 databases.POST /d1/database/{database_id}/raw - Returns the query result rows as arrays rather than objects.#12402 63f1adb Thanks @dependabot! - Update dependencies of "miniflare", "wrangler"
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20260131.0 | 1.20260203.0 |
#12418 ba13de9 Thanks @dependabot! - Update dependencies of "miniflare", "wrangler"
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20260203.0 | 1.20260205.0 |
The following dependency versions have been updated:
#12186 0c9625a Thanks @penalosa! - Add CF-Worker header to outgoing fetch requests in local development to match production behavior. A new optional zone option allows specifying the zone value for the header. When not specified, the header defaults to ${worker-name}.example.com.
#12185 f7aa8c7 Thanks @penalosa! - Add timestamp field to the version metadata binding in local development. The version metadata binding now includes id, tag, and timestamp fields, making it easier to test version-aware logic locally.
#12289 0aaf080 Thanks @dependabot! - Update dependencies of "miniflare", "wrangler"
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20260128.0 | 1.20260129.0 |
#12295 b981db5 Thanks @dependabot! - Update dependencies of "miniflare", "wrangler"
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20260129.0 | 1.20260130.0 |
#12355 a113c0d Thanks @dependabot! - Update dependencies of "miniflare", "wrangler"
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20260130.0 | 1.20260131.0 |
The following APIs have been (mostly) implemented: GET /storage/kv/namespaces - List namespaces GET /storage/kv/namespaces/:id/keys - List keys GET /s
#12152 8a210af Thanks @emily-shen! - Implement local KV API for experimental/WIP local resource explorer
The following APIs have been (mostly) implemented: GET /storage/kv/namespaces - List namespaces GET /storage/kv/namespaces/:id/keys - List keys GET /storage/kv/namespaces/:id/values/:key - Get value PUT /storage/kv/namespaces/:id/values/:key - Write value DELETE /storage/kv/namespaces/:id/values/:key - Delete key POST /storage/kv/namespaces/:id/bulk/get - Bulk get values
#12183 17961bb Thanks @dependabot! - chore: update dependencies of "miniflare", "wrangler"
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20260124.0 | 1.20260127.0 |
#12196 52fdfe7 Thanks @dependabot! - chore: update dependencies of "miniflare", "wrangler"
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20260127.0 | 1.20260128.0 |
In order to prevent possible npm vulnerability attacks, the team's policy is to bundle dependencies in our packages where possible. This helps ensure…
#12008 e414f05 Thanks @penalosa! - Add support for customising the inspector IP address
Adds a new --inspector-ip CLI flag and dev.inspector_ip configuration option to allow customising the IP address that the inspector server listens on. Previously, the inspector was hardcoded to listen only on 127.0.0.1.
Example usage:
# CLI flag
wrangler dev --inspector-ip 0.0.0.0
// wrangler.json
{
"dev": {
"inspector_ip": "0.0.0.0"
}
}
#12034 05714f8 Thanks @emily-shen! - Add a no-op local explorer worker, which is gated by the experimental flag X_LOCAL_EXPLORER.
#11853 014e7aa Thanks @43081j! - Use built-in stripVTControlCharacters utility rather than the strip-ansi package.
#12040 77e82d2 Thanks @dependabot! - chore: update dependencies of "miniflare", "wrangler"
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20260120.0 | 1.20260122.0 |
#12061 f08ef21 Thanks @dependabot! - chore: update dependencies of "miniflare", "wrangler"
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20260122.0 | 1.20260123.0 |
#12088 0641e6c Thanks @dependabot! - chore: update dependencies of "miniflare", "wrangler"
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20260123.0 | 1.20260124.0 |
#11897 bbd8a5e Thanks @dario-piotrowicz! - Bundle the zod dependency to reduce supply chain attack surface
In order to prevent possible npm vulnerability attacks, the team's policy is to bundle dependencies in our packages where possible. This helps ensure that only trusted code runs on the user's system, even if compromised packages are later published to npm.
This change bundles zod (a pure JavaScript validation library with no native dependencies)
into miniflare and @cloudflare/vitest-pool-workers.
Other dependencies remain external for technical reasons:
sharp: Native binary with platform-specific buildsundici: Dynamically required at runtime in worker threadsws: Has optional native bindings for performanceworkerd: Native binary (Cloudflare's JavaScript runtime)@cspotcode/source-map-support: Uses require.cache manipulation at runtimeyouch: Dynamically required for lazy loadingThe following dependency versions have been updated:
#11993 788bf78 Thanks @dependabot! - chore: update dependencies of "miniflare", "wrangler"
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20260116.0 | 1.20260120.0 |
Miniflare now supports the simplified MessageBuilder interface for sending emails, alongside the existing EmailMessage support.
#11942 133bf95 Thanks @penalosa! - Add support for Email Sending API's MessageBuilder interface in local mode
Miniflare now supports the simplified MessageBuilder interface for sending emails, alongside the existing EmailMessage support.
Example usage:
await env.EMAIL.send({
from: { name: "Alice", email: "alice@example.com" },
to: ["bob@example.com"],
subject: "Hello",
text: "Plain text version",
html: "<h1>HTML version</h1>",
attachments: [
{
disposition: "attachment",
filename: "report.pdf",
type: "application/pdf",
content: pdfData,
},
],
});
In local mode, email content (text, HTML, attachments) is stored to temporary files that you can open in your editor or browser for inspection. File paths are logged to the console when emails are sent.
#11925 8e4a0e5 Thanks @dependabot! - chore: update dependencies of "miniflare", "wrangler"
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20260114.0 | 1.20260115.0 |
#11942 133bf95 Thanks @penalosa! - chore: update dependencies of "miniflare", "wrangler"
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20260115.0 | 1.20260116.0 |
#11967 202c59e Thanks @emily-shen! - chore: update undici
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| undici | 7.14.0 | 7.18.2 |
When using the upstream option in Miniflare, the Host header is rewritten to match the upstream server, which means the original hostname is lost. Thi
#11883 4714ca1 Thanks @dario-piotrowicz! - Add MF-Original-Hostname header when using the upstream option
When using the upstream option in Miniflare, the Host header is rewritten to match the upstream server, which means the original hostname is lost. This change adds a new MF-Original-Hostname header that preserves the original hostname from the incoming request.
This allows Workers to access the original hostname when proxying requests through an upstream server:
export default {
async fetch(request) {
const originalHostname = request.headers.get("MF-Original-Hostname");
// originalHostname contains the hostname before it was rewritten
},
};
#11908 e78186d Thanks @dependabot! - chore: update dependencies of "miniflare", "wrangler"
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20260111.0 | 1.20260114.0 |
#11898 c17e971 Thanks @petebacondarwin! - Bundle more third-party dependencies to reduce supply chain risk
Previously, several small utility packages were listed as runtime dependencies and installed separately. These are now bundled directly into the published packages, reducing the number of external dependencies users need to trust.
Bundled dependencies:
acorn, acorn-walk, exit-hook, glob-to-regexp, stoppablemime@remix-run/node-fetch-server, defu, get-port, picocolors, tinyglobbybirpc, devalue, get-port, semverWhen running wrangler dev with a worker that has cron triggers, the warning message displayed an invalid URL like curl "http://localhost:undefined/cdn
#11494 ed60c4f Thanks @jalmonter! - Fix scheduled trigger warning showing undefined port
When running wrangler dev with a worker that has cron triggers, the warning message displayed an invalid URL like curl "http://localhost:undefined/cdn-cgi/handler/scheduled" because the port wasn't yet determined when the warning was logged.
Moved the warning to after the proxy server is fully ready, where the actual public URL and port are known.
#11831 faa5753 Thanks @dependabot! - chore: update dependencies of "miniflare", "wrangler"
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20260107.1 | 1.20260108.0 |
#11844 e574ef3 Thanks @dependabot! - chore: update dependencies of "miniflare", "wrangler"
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20260108.0 | 1.20260109.0 |
#11872 b6148ed Thanks @dependabot! - chore: update dependencies of "miniflare", "wrangler"
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20260109.0 | 1.20260111.0 |
#11816 fc96e5f Thanks @dario-piotrowicz! - Bump sharp dependency (from 0.33.5 to 0.34.5)
The following dependency versions have been updated:
#11822 97e67b9 Thanks @dependabot! - chore: update dependencies of "miniflare", "wrangler"
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20260103.0 | 1.20260107.1 |
getOutput(): Returns the output of the successfully completed Workflow instance.
#11648 eac5cf7 Thanks @pombosilva! - Add Workflows test handlers in vitest-pool-workers to get the Workflow instance output and error:
getOutput(): Returns the output of the successfully completed Workflow instance.getError(): Returns the error information of the errored Workflow instance.Example:
// First wait for the workflow instance to complete:
await expect(
instance.waitForStatus({ status: "complete" })
).resolves.not.toThrow();
// Then, get its output
const output = await instance.getOutput();
// Or for errored workflow instances, get their error:
await expect(
instance.waitForStatus({ status: "errored" })
).resolves.not.toThrow();
const error = await instance.getError();
#11714 65d1850 Thanks @dependabot! - chore: update dependencies of "miniflare" package
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20251217.0 | 1.20251219.0 |
#11732 1615fce Thanks @dependabot! - chore: update dependencies of "miniflare" package
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20251219.0 | 1.20251221.0 |
#11748 b2769bf Thanks @dependabot! - chore: update dependencies of "miniflare" package
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20251221.0 | 1.20251223.0 |
#11791 554a4df Thanks @dependabot! - chore: update dependencies of "miniflare" package
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20251223.0 | 1.20260103.0 |
#11642 8eede3f Thanks @petebacondarwin! - Fix intermittent "Fetch failed" errors in Miniflare tests on Windows
Miniflare tests would occasionally fail with "Fetch failed" errors (particularly on Windows CI runners) due to race conditions between undici's Keep-Alive mechanism and the Miniflare server closing idle connections. Miniflare now configures the Dispatcher to prevent connection reuse and eliminate these race condition errors.
#11493 6a05b1c Thanks @GameRoMan! - Update zod from 3.22.3 to 3.25.76
The following dependency versions have been updated:
#11679 ae1ad22 Thanks @dependabot! - chore: update dependencies of "miniflare" package
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20251213.0 | 1.20251217.0 |
#11663 737c0f4 Thanks @NuroDev! - Fix Durable Object RPC calls from Node.js blocking the event loop, preventing Promise.race() and timeouts from working correctly.
Previously, RPC calls from Node.js to Durable Objects would block the Node.js event loop, causing Promise.race() with timeouts to never resolve. This fix ensures that RPC calls properly yield control back to the event loop, allowing concurrent operations and timeouts to work as expected.
The following dependency versions have been updated:
#11596 5d085fb Thanks @dependabot! - chore: update dependencies of "miniflare" package
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20251210.0 | 1.20251211.0 |
#11622 b75b710 Thanks @dependabot! - chore: update dependencies of "miniflare" package
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20251211.0 | 1.20251212.0 |
#11640 1e9be12 Thanks @dependabot! - chore: update dependencies of "miniflare" package
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20251212.0 | 1.20251213.0 |
The following dependency versions have been updated:
#11552 31c162a Thanks @dependabot! - chore: update dependencies of "miniflare" package
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20251202.0 | 1.20251205.0 |
#11583 bd5f087 Thanks @dependabot! - chore: update dependencies of "miniflare" package
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20251205.0 | 1.20251209.0 |
#11584 c6dd86f Thanks @dependabot! - chore: update dependencies of "miniflare" package
The following dependency versions have been updated:
| Dependency | From | To |
|---|---|---|
| workerd | 1.20251209.0 | 1.20251210.0 |
### Patch Changes - #11443 `56e78c8` Thanks @Ltadrian! - Improve local Hyperdrive binding latency on Windows.
One column per quarter.