miniflare
4.20260730.0 · 30 Jul 2026MIT57.5M / weekRepositoryHomepagenpmAtom feed
Upgrading miniflare From 4.20260611.0 to 4.20260730.0
17 releases in betweenevery note read
Security
- 4.20260617.0
Bump
wsfrom 8.20.1 to 8.21.0 to address GHSA-96hv-2xvq-fx4p
Release by release
- New
Add JSON output to
/cdn-cgi/handler/email - Fixed
Fix the local Images binding transform (
env.IMAGES.input(...).transform(...)) ignoring thefit,gravity, andbackgroundoptions. Previously, local dev always letterboxed transformed images with black bars regardless of the options passed in. Local dev now respectsfit,gravity, andbackground, matching production Images binding behavior. - Fixed
Disable the keep-alive timeout on the loopback server
- Fixed
Capture Workflows invocations in local observability
- New
- New
Support passing V8 flags to
workerdvia theMINIFLARE_WORKERD_V8_FLAGSenvironment variable - New
Add a local S3-compatible API for R2 buckets at
/cdn-cgi/local/r2/s3/<bucket-id>, where<bucket-id>is the ID the bucket is configured with in ther2Bucketsoption - New
Support
connect()on remote VPC Network and VPC Service bindings in local development - Fixed
Fix
getWithMetadatadropping metadata for falsy KV values - Fixed
Hide the workerd console window on Windows when the parent process has no console. Spawning workerd without
windowsHide: truecaused Windows Terminal to open a visible, focus-stealing window for background or detached parents (for example Astro'sastro dev --background).
- New
- New
Add local-dev observability
- Fixed
Fix incorrect byte limit reported in the local Queues batch-size error
- Fixed
Recover local development after the Workers runtime crashes
- New
- New
Add support for redacting sensitive Workflows step output in local dev.
- Fixed
Report the Worker's error for
HEADrequests instead of an internal JSON parse error
- New
- New
Add a
handleUncaughtErrorshared option that receives uncaught Worker exceptions - New
Add Durable Object storage access to
createTestHarness() - Fixed
Improve asset serving performance by removing an unnecessary internal dispatch hop
- Fixed
Keep reporting uncaught Worker errors when a stack frame's file URL has no local path
- Fixed
Improve routing performance for Workers with assets
- Fixed
Prevent local Browser Rendering teardown from hanging when Chrome does not exit
- Fixed
Prevent concurrent Miniflare instances from deleting each other's temporary email sessions
- New
- New
Add
unsafeEvictDurableObject()for targeted Durable Object eviction - New
Allow
listDurableObjectIds()to accept Durable Object class names as well as binding names. - New
Add convenient logging for worker emails in the project directory. In addition to the system's temp directory, logs for emails sent by workers are also written to a local temp directory defined by the calling process, e.g for an simple text email sent via Wrangler this is
.wrangler/tmp/email/<session>/email-text/<message-uuid>.txt(and related files) in the project root. Callers of Miniflare can control this location via the newdefaultProjectTmpPathoption, which Wrangler and Vite plugin now set automatically.
- New
- New
Support dynamic retry delays for Workflow steps in local dev
- New
- New
Add
listDurableObjectIds()to Miniflare - New
Add rollback support when terminating Workflow instances
- New
17 internal lines (docs, tests, tooling) left out.
A whole project to check? Paste its package.json in the dependency check: every deprecated, outdated or vulnerable dependency, with what to upgrade to. Free, no account.