Packages

miniflare

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

Upgrading miniflare From 4.20260205.0 to 4.20260730.0

57 releases in betweenevery note read

  1. 4.20260205.0yours
  2. 7 releases
  3. 4.20260310.0security
  4. 24 releases
  5. 4.20260520.0security
  6. 8 releases
  7. 4.20260617.0security
  8. 14 releases
  9. 4.20260730.0target

Before you upgrade

Tick each one off as you go
  • 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

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

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