Packages

miniflare

4.20260730.0 · 30 Jul 2026MIT57.5M / weekRepositoryHomepagenpmAtom feed

Upgrading miniflare From 1.3.0 to 4.20260730.0

291 releases in betweennotes for 239

Other targets from 1.3.0Newest 1.x1.4.1
3.0.0, 2.0.0 have no release note on GitHub or in the repository's changelog, so their breaking changes are missing from the counts below; the migration guide covers them.
  1. 1.3.0yours
  2. 5 releases
  3. 2.0.0major
  4. 24 releases
  5. 3.0.0major
  6. 199 releases
  7. 4.20260124.0security
  8. 10 releases
  9. 4.20260310.0security
  10. 24 releases
  11. 4.20260520.0security
  12. 8 releases
  13. 4.20260617.0security
  14. 14 releases
  15. 4.20260730.0target
  16. 10 pre
5+
changes to make
0
advisories fixed
160+
new
194+
fixes

Counted from 239 of 291 release notes. Advisories are counted from the advisory database, in full.

Start here

Before you upgrade

Tick each one off as you go
  • Breaking4.20251011.2
  • Breaking4.20250310.0
  • Breaking4.20250310.0
  • Breaking3.20240909.3
  • Deprecated4.20260401.0

Security

  • Bump ws from 8.20.1 to 8.21.0 to address GHSA-96hv-2xvq-fx4p

    4.20260617.0
  • Bump ws from 8.18.0 to 8.20.1 to address GHSA-58qx-3vcg-4xpx

    4.20260520.0
  • Bump hono to ^4.12.5 and devalue to ^5.6.3 to address security vulnerabilities

    4.20260310.0
  • In order to prevent possible npm vulnerability attacks, the team's policy is to bundle

    4.20260124.0

Release by release

  1. 4.20260730.0

    30 Jul 20261 new · 3 fixes
    • New

      Add JSON output to /cdn-cgi/handler/email

    • Fixed

      Fix the local Images binding transform (env.IMAGES.input(...).transform(...)) ignoring the fit, gravity, and background options. Previously, local dev always letterboxed transformed images with black bars regardless of the options passed in. Local dev now respects fit, gravity, and background, matching production Images binding behavior.

    • Fixed

      Disable the keep-alive timeout on the loopback server

    • Fixed

      Capture Workflows invocations in local observability

  2. 4.20260722.1

    28 Jul 20263 new · 2 fixes
    • New

      Support passing V8 flags to workerd via the MINIFLARE_WORKERD_V8_FLAGS environment 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 the r2Buckets option

    • New

      Support connect() on remote VPC Network and VPC Service bindings in local development

    • Fixed

      Fix getWithMetadata dropping metadata for falsy KV values

    • Fixed

      Hide the workerd console window on Windows when the parent process has no console. Spawning workerd without windowsHide: true caused Windows Terminal to open a visible, focus-stealing window for background or detached parents (for example Astro's astro dev --background).

  3. 4.20260722.0

    23 Jul 20261 new · 2 fixes
    • 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

  4. 4.20260721.0

    21 Jul 20261 new · 1 fix
    • New

      Add support for redacting sensitive Workflows step output in local dev.

    • Fixed

      Report the Worker's error for HEAD requests instead of an internal JSON parse error

  5. 4.20260714.0

    17 Jul 20262 new · 5 fixes
    • New

      Add a handleUncaughtError shared 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

  6. 4.20260710.0

    15 Jul 20263 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 new defaultProjectTmpPath option, which Wrangler and Vite plugin now set automatically.

  7. 4.20260708.1

    9 Jul 20261 new
    • New

      Support dynamic retry delays for Workflow steps in local dev

  8. 4.20260708.0

    9 Jul 20262 new
    • New

      Add listDurableObjectIds() to Miniflare

    • New

      Add rollback support when terminating Workflow instances

7 other lines we could not sort, mostly version bumps
  • JSRPC over Service Bindings

    4.20250816.0
  • JSRPC over Dispatch Namespace Bindings

    4.20250816.0
  • Dispatch Namespaces

    4.20250525.1
  • fixtures/remix-pages-app had a bunch of warnings about impending features that it should be upgraded to, so I did that. (tbh this one needs a full upgrade of packages, but we'll get to that later when we're upgrading across the codebase)

    3.20240610.1
  • Updated @microsoft/api-extractor so it didn't complain that it didn't match the typescript version (that we'd recently upgraded)

    3.20240610.1
  • It also silenced a bunch of warnings when exporting types from wrangler. We'll need to fix those, but we'll do that when we work on unstable_dev etc.

    3.20240610.1
  • workers-playground was complaining about the size of the bundle being generated, so I increased the limit on it

    3.20240610.1

176 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.