Cloudflare Workers
Backend & Infra⛅️ Home to Wrangler, the CLI for Cloudflare Workers®
Release History
wrangler@4.83.04 fixes1 featureThis release stabilizes the `wrangler containers` commands and fixes several issues related to network request blocking during startup and incorrect fetch error handling. It also updates the Python Workers runtime to correctly handle imported JS files as ESM modules.
create-cloudflare@2.67.05 fixes2 featuresThis release upgrades the OpenAPI worker template dependencies to chanfana v3.3 and Zod v4, introducing template improvements and fixing scaffolding issues. Dependency updates across related tools like create-vite and create-analog were also performed.
@cloudflare/local-explorer-ui@0.13.01 featureThis minor release introduces quality-of-life improvements by adding standard shift-click multi-select behavior to the R2 object list interface.
@cloudflare/vitest-pool-workers@0.14.7This patch release updates the underlying dependencies, specifically miniflare to version 4.20260415.0 and wrangler to version 4.83.0.
@cloudflare/workers-shared@0.19.2Refactored the asset-worker invocation logic to prepare for future gradual rollout capabilities, with no functional change for users today.
@cloudflare/vite-plugin@1.32.31 fixThis patch release hardens file serving security in the Vite development server and updates underlying dependencies, including Miniflare and Wrangler.
@cloudflare/pages-shared@0.13.125This patch release primarily focuses on updating dependencies, specifically bumping miniflare to version 4.20260415.0.
@cloudflare/workers-utils@0.16.11 fixThis patch release fixes a bug where properties in the `previews` configuration were incorrectly marked as required.
miniflare@4.20260415.05 fixes1 featureThis patch release focuses on stability and performance improvements, including fixing fetch errors for non-2xx responses, resolving crashes with remote bindings in `wrangler dev`, and making startup network operations non-blocking.
wrangler@4.82.21 featureThis patch release introduces support for Flagship OAuth scopes during user login via wrangler.
@cloudflare/vite-plugin@1.32.2This patch release primarily updates internal dependencies, specifically upgrading wrangler to version 4.82.2.
@cloudflare/vitest-pool-workers@0.14.6This patch release primarily updates internal dependencies, specifically upgrading wrangler to version 4.82.2.
wrangler@4.82.12 fixesThis patch release disables invalid flagship OAuth scopes by default and improves compatibility with newer Vike configuration file formats by correctly resolving identifier exports in autoconfig.
@cloudflare/vite-plugin@1.32.1This patch release primarily focused on updating internal dependencies, specifically updating wrangler to version 4.82.1.
@cloudflare/vitest-pool-workers@0.14.5This patch release primarily focused on updating internal dependencies, specifically updating wrangler to version 4.82.1.
create-cloudflare@2.66.5This patch release updates dependencies for "create-cloudflare", specifically upgrading create-vike from 0.0.599 to 0.0.616.
wrangler@4.82.01 fix8 featuresThis release introduces support for Preview deployments via `wrangler preview`, new commands for managing Browser Rendering sessions, and integrates Flagship feature flag binding support. It also enhances machine readability for JSON output by moving proxy notices to stderr and adds telemetry to the local REST API.
@cloudflare/vite-plugin@1.32.01 featureThis release introduces a new development shortcut to inspect binding states during local development and updates underlying dependencies.
@cloudflare/local-explorer-ui@0.12.03 fixes5 featuresThis release enhances the local explorer experience with UI improvements like collapsible sidebar groups, theme persistence, and better error handling for routes. It also updates the agent prompt copying feature to use the correct local runtime origin.
@cloudflare/pages-shared@0.13.124This patch release primarily consists of dependency updates, specifically upgrading miniflare to version 4.20260410.0.
@cloudflare/vitest-pool-workers@0.14.4This patch release updates internal dependencies, specifically upgrading wrangler to version 4.82.0 and miniflare to version 4.20260410.0.
miniflare@4.20260410.02 fixes2 featuresThis release introduces support for Cloudflare Flagship feature flag bindings and adds telemetry collection to the local REST API. Bug fixes include returning queue metrics from broker endpoints.
@cloudflare/workers-utils@0.16.03 featuresThis release introduces support for Cloudflare Flagship feature flag bindings, enabling Workers to evaluate feature flags directly. Configuration is managed via `wrangler.json`.
create-cloudflare@2.66.4This patch release updates dependencies for "create-cloudflare", specifically upgrading create-docusaurus from 3.9.2 to 3.10.0.
@cloudflare/vitest-pool-workers@0.14.3This patch release primarily updates internal dependencies, specifically miniflare to version 4.20260409.0 and wrangler to version 4.81.1.
miniflare@4.20260409.01 fix1 featureThis release enhances the local explorer by listing DO instances with names and fixes an issue related to resource binding in the explorer. Dependencies, including workerd, have also been updated.
@cloudflare/vite-plugin@1.31.2This patch release primarily updates internal dependencies, specifically miniflare to version 4.20260409.0 and wrangler to version 4.81.1.
@cloudflare/workflows-shared@0.9.02 featuresThis minor release enhances the workflow step context by adding 'step' and 'config' properties to the callback received by step.do().
@cloudflare/local-explorer-ui@0.11.01 fix2 featuresThis minor release enhances the local explorer experience by adding an animated logo, improving DO instance listing, and fixing a binding issue for resources.
@cloudflare/pages-shared@0.13.123This patch release primarily focused on updating internal dependencies, specifically updating miniflare to version 4.20260409.0.
wrangler@4.81.12 fixesThis patch release primarily updates internal dependencies, including 'workerd' and 'miniflare', and fixes a critical bug related to AI Search bindings not working correctly during local development.
create-cloudflare@2.66.31 fix1 featureThis patch release primarily updates dependencies within "create-cloudflare" and introduces improved error handling for unsupported Node.js versions.
@cloudflare/pages-shared@0.13.122This patch release primarily consists of dependency updates, specifically upgrading miniflare to version 4.20260405.0.
@cloudflare/vite-plugin@1.31.1This patch release updates underlying dependencies, specifically Miniflare to version 4.20260405.0 and Wrangler to version 4.81.0.
@cloudflare/workflows-shared@0.8.01 featureThis release introduces support for ReadableStream in workflow steps to handle outputs larger than 1MB. This is achieved by natively serializing and replaying stream chunks on the workers platform.
@cloudflare/local-explorer-ui@0.10.01 featureThis release introduces an overhaul of the local explorer UI color palette, moving towards using Kumo styles for a more consistent look.
miniflare@4.20260405.01 fix1 featureThis release introduces the local explorer's OpenAPI specification endpoint and fixes a Hyperdrive TLS configuration bug. It also updates the local mock for Images binding to align with the latest workerd API.
@cloudflare/vitest-pool-workers@0.14.21 fixThis patch release improves error handling for unsupported V8 coverage providers by rejecting them early with a clear message. Dependencies including miniflare and wrangler have also been updated.
wrangler@4.81.02 fixes3 featuresThis release introduces comprehensive new CLI commands for managing Cloudflare Email Routing and Email Sending features via `wrangler`. It also includes dependency updates and fixes an issue with framework auto-detection and configuration format rendering in `wrangler dev`.
@cloudflare/vite-plugin@1.31.02 fixes1 featureThis release introduces experimental headful browser rendering for local debugging and fixes a SyntaxError related to trailing comments in SSR-transformed modules. It also updates how the local workerd compatibility date is determined, deprecating the old utility function.
create-cloudflare@2.66.21 fix1 featureThis patch updates the default compatibility date resolution to use today's date, improving reliability across various package manager environments, especially pnpm.
miniflare@4.20260401.01 fix2 featuresThis release introduces experimental headful browser rendering for local development and adds support for VPC network bindings. It also deprecates the `supportedCompatibilityDate` export and fixes a module parsing bug in Miniflare.
@cloudflare/workers-utils@0.15.03 featuresThis release introduces experimental headful browser rendering for local debugging and adds support for VPC network bindings. Several compatibility date utilities have been removed from the public API in favor of a utility from `@cloudflare/workers-utils`.
@cloudflare/pages-shared@0.13.121This patch release primarily involves updating dependencies, specifically upgrading miniflare to version 4.20260401.0.
wrangler@4.80.06 fixes3 featuresThis release introduces experimental headful local development, adds support for AI Search and VPC network bindings, and includes several bug fixes related to build error visibility, D1 migration ordering, and source phase imports.
@cloudflare/vitest-pool-workers@0.14.11 fixThis patch updates dependencies and refactors log processing in `vitest-pool-workers` to utilize miniflare's structured logging capabilities for cleaner output handling.
@cloudflare/cli@1.4.01 featureThis minor release introduces utility functions to manage Wrangler-related entries within gitignore files automatically.
create-cloudflare@2.66.1This patch release primarily updates various dependencies within the "create-cloudflare" toolset, including updates for create-react-router, create-astro, @angular/create, create-waku, and create-vue.
@cloudflare/vite-plugin@1.30.31 fixThis patch updates dependencies, including wrangler and miniflare, and fixes a bug where the 'connect' method was missing from key lists in the runner worker, causing type check failures.
@cloudflare/workers-playground@0.4.31 fixThis patch fixes a TypeError occurring in Vite 8 builds by adjusting how the `@cloudflare/style-provider` package is resolved, accommodating Vite 8's switch to the rolldown bundler.
miniflare@4.20260329.01 fix2 featuresThis release enhances local development tooling by fully implementing devtools endpoints for browser rendering and adding comprehensive Workflows support to the local explorer UI. It also includes a fix for noisy file handle errors on Windows during Miniflare disposal.
@cloudflare/vitest-pool-workers@0.14.03 fixes1 featureThis release introduces a testing utility to skip retry delays in Workflows and improves compatibility with alternative testing setups like Vite+. Several minor bug fixes address noise in test logs and improve runtime compatibility date handling.
@cloudflare/workflows-shared@0.7.22 featuresThis patch introduces comprehensive Workflows dashboard support within the local development explorer UI, allowing developers to view and manage workflow instances locally.
wrangler@4.79.05 fixes2 featuresThis release introduces CLI commands for managing Cloudflare AI Search and adds local development support for Workflows commands. It also includes several stability improvements, particularly around project auto-configuration and asset directory handling.
@cloudflare/pages-shared@0.13.120This patch release primarily updates dependencies, specifically bumping miniflare to version 4.20260329.0.
@cloudflare/cli@1.3.02 featuresThis minor release introduces new reusable utility functions for running shell commands and installing packages, exported via dedicated sub-paths in the @cloudflare/cli package.
@cloudflare/codemod@1.1.01 featureThis minor release introduces the new @cloudflare/codemod package containing internal AST-based codemod utilities built using recast.
@cloudflare/vite-plugin@1.30.21 fixThis patch release fixes a concurrency issue related to deferred dynamic imports in Workers, preventing I/O errors by correctly scoping imports within Durable Object contexts. It also updates several dependencies.
@cloudflare/pages-shared@0.13.119This patch release primarily updates dependencies, specifically upgrading miniflare to version 4.20260317.3.
@cloudflare/containers-shared@0.13.11 featureThis patch release introduces the library-push flag for containers registries credentials, although it is not currently available for public use.
create-cloudflare@2.66.0Dependencies in Python workers templates were updated, adding workers-runtime-sdk and removing webtypy.
miniflare@4.20260317.31 fix2 featuresThis release introduces new AI Search bindings and enables local development support for Cloudflare Stream bindings. A critical bug fix was also implemented to correctly anchor glob patterns, preventing incorrect file matching in module rules.
@cloudflare/vitest-pool-workers@0.13.53 fixes2 featuresThis patch release fixes several issues related to Durable Object communication, module loading behavior, and test stability. It also introduces new testing utilities for managing secrets.
wrangler@4.78.03 fixes7 featuresThis release introduces significant enhancements for local development and deployment, including support for Access Service Tokens, new AI Search bindings, and local Stream binding support. It also improves VPC service configuration and fixes several bugs related to Angular setup and dry-run validation.
@cloudflare/workers-utils@0.14.0Breaking1 featureThis release introduces new binding types for AI Search and enforces stricter validation on queue consumer configurations within wrangler.toml.
@cloudflare/vite-plugin@1.30.11 fix1 featureThis patch release fixes an issue preventing subpath imports for various module types and enables this functionality via configuration in `package.json`. Dependencies including wrangler and miniflare were also updated.
@cloudflare/pages-shared@0.13.118This patch release primarily updates dependencies, including an update to miniflare to version 4.20260317.2.
@cloudflare/playground-preview-worker@0.3.2Breaking1 featureThis patch replaces the deprecated and unmaintained `promjs` library with the new `MetricsRegistry` from `@cloudflare/workers-utils/prometheus-metrics` to ensure continued compatibility and maintenance for Prometheus metrics exposition.
miniflare@4.20260317.25 fixes2 featuresThis patch release for workers-sdk focuses on improving Miniflare's local development experience by fixing configuration parsing issues for D1, KV, Pipelines, and R2 bindings, and by disabling request timeouts in the undici Pool.
create-cloudflare@2.65.01 fix1 featureThis release defaults source map uploads to true for new projects and corrects the Qwik adapter scaffolding when targeting Cloudflare Workers. It also includes several minor dependency updates within create-cloudflare templates.
@cloudflare/workflows-shared@0.7.11 fixThis patch release fixes a critical bug where timed-out event waiters in workflows could lead to subsequent workflows hanging indefinitely.
@cloudflare/vitest-pool-workers@0.13.4This patch release updates dependencies, specifically upgrading wrangler to v4.77.0 and miniflare to v4.20260317.2, alongside minor test and fixture updates for Vitest 4.
@cloudflare/format-errors@0.0.8Breaking1 featureThis patch replaces the deprecated and unmaintained `promjs` library with the new `MetricsRegistry` from `@cloudflare/workers-utils/prometheus-metrics` to ensure continued compatibility and stability for Prometheus metrics generation.
@cloudflare/workers-playground@0.4.2BreakingThis patch release removes the non-functional cf-requirements support for Python workers.
wrangler@4.77.0Breaking2 fixes3 featuresThis release introduces validation for required secrets during deployment and upload using the experimental `secrets` configuration property. It also improves the reliability of remote development sessions and fixes Qwik scaffolding issues for Workers targets.
@cloudflare/edge-preview-authenticated-proxy@0.3.11 featureThe SDK replaced the deprecated and unmaintained `promjs` library with a new `MetricsRegistry` implementation for Prometheus metrics output. The `/exchange` preview session endpoint was also restored.
@cloudflare/local-explorer-ui@0.9.01 fix4 featuresThis release enhances the local explorer UI by adding worker filtering for shared dev registries and introducing experimental support for R2 operations. A bug related to listing internal Durable Object tables was also fixed.
miniflare@4.20260317.11 fix4 featuresThis release enhances the local development experience by enabling the local explorer by default, adding R2 support, and introducing worker filtering to the explorer UI. Workflow instances also gained new control methods (pause, resume, restart, terminate) locally.
@cloudflare/vitest-pool-workers@0.13.31 featureThis patch release updates dependencies and enhances the workflows testing utility to support waiting for "terminated" and "paused" states.
@cloudflare/vite-plugin@1.30.02 fixes2 featuresThis release enables the local explorer UI by default for inspecting local resources during development and includes a fix for middleware splicing issues across different Vite versions.
@cloudflare/pages-shared@0.13.117This patch release primarily updates dependencies, specifically upgrading miniflare to version 4.20260317.1.
@cloudflare/workflows-shared@0.7.01 featureThis release introduces management capabilities for workflow instances during local development, allowing users to pause, resume, restart, and terminate them.
wrangler@4.76.01 fix3 featuresThis release introduces Stream binding support, enables the local explorer by default, and updates `wrangler containers list` to use a paginated API endpoint. It also adds compatibility fixes for older Astro versions.
@cloudflare/lint-config-shared@1.2.11 featureThis patch introduces a new ESLint rule to enforce importing `expect` from the test context rather than directly from `vitest` for improved test safety.
@cloudflare/unenv-preset@2.16.01 featureSeveral experimental Node.js module compatibility flags are now graduated and enabled by default for workers targeting compatibility date 2026-03-17 or later.
@cloudflare/containers-shared@0.13.03 featuresThe SDK upgraded the internal proxy-everything dependency to support DNS query filtering for constrained outbound HTTP requests. Additionally, the `wrangler containers list` command was rewritten to use a paginated Dash API endpoint for improved listing functionality.
@cloudflare/workers-utils@0.13.01 featureThis minor release introduces support for Stream bindings within Wrangler and workers-utils, improving configuration consistency for stream resources.
@cloudflare/pages-shared@0.13.116This patch release primarily updates dependencies, including bumping miniflare to version 4.20260317.0.
create-cloudflare@2.64.9This patch release primarily updates dependencies within the "create-cloudflare" tooling, including updates to create-next-app, nuxi, create-astro, @angular/create, and create-qwik.
@cloudflare/vitest-pool-workers@0.13.2This patch release updates the bundled dependencies, specifically upgrading wrangler to version 4.75.0 and miniflare to version 4.20260317.0.
wrangler@4.75.02 fixes2 featuresThis release introduces experimental support for managing Cloudflare Tunnels directly through new `wrangler tunnel` commands and fixes a critical bug where local debugging would freeze scripts if DevTools was not attached.
@cloudflare/chrome-devtools-patches@0.1.51 featureThe DevTools frontend deployment infrastructure has been migrated from Cloudflare Pages to a Workers + Assets project, updating deployment commands accordingly.
@cloudflare/vite-plugin@1.29.11 fixThis patch updates dependencies and introduces logic to select the correct Vite module runner implementation during development based on the user's installed Vite version to maintain compatibility.
miniflare@4.20260317.0This patch release primarily updates internal dependencies, including undici and workerd versions, and migrates the chrome-devtools-patches deployment mechanism to use Workers + Assets.
wrangler@4.74.03 fixes3 featuresThis release introduces the ability to deploy secrets alongside Worker code via `--secrets-file` and adds a new command to list container instances. Bug fixes address issues with monorepo autoconfiguration and asset upload error handling.
miniflare@4.20260312.11 fixThis patch addresses a bug in the local explorer where Miniflare's modification of host and origin headers caused same-origin requests to be blocked when routes were configured.
@cloudflare/pages-shared@0.13.115This patch release primarily updates internal dependencies, specifically miniflare to version 4.20260312.1.
@cloudflare/local-explorer-ui@0.8.21 fixThis patch release primarily addresses a visual bug in the data studio where the table selection dropdown had an incorrect z-index, causing display issues.
@cloudflare/vite-plugin@1.29.01 fix1 featureThis release adds support for Vite 8 as a peer dependency and fixes a critical crash related to early HMR event handling during development server startup.
@cloudflare/containers-shared@0.12.02 featuresThis release introduces a new `wrangler containers instances` command to list container instances for an application and adds pagination support to the underlying API client.
Common Errors
MiniflareCoreError4 reportsMiniflareCoreError often arises from conflicting or improperly configured bindings, especially when using browser bindings or multiple workers in the same environment. Ensure all bindings are correctly defined in your wrangler.toml or CLI arguments and that there are no conflicting binding types (e.g., attempting to use browser bindings with module workers simultaneously). If using multiple workers, verify each worker has unique binding names to avoid overlapping modules. Finally, double-check that the referenced modules in your bindings are correctly present and resolvable in your project.
InferenceUpstreamError1 reportThe "InferenceUpstreamError" in Cloudflare Workers AI usually indicates a problem with the model being unavailable or timing out when accessed by the Workers AI inference server. Ensure the model ID is correct, the model is properly deployed and active on the Cloudflare AI platform, and that the Worker's request doesn't exceed any limits (memory, CPU time). Double-check Cloudflare status pages for service outages affecting Workers AI, and consider implementing retry logic with exponential backoff in your worker to gracefully handle temporary upstream issues; also consider downgrading wrangler to version 4.35.0 to mitigate any recent breaking changes.
DataCloneError1 reportThe DataCloneError in Cloudflare Workers usually arises when attempting to pass non-cloneable objects (like functions, class instances with methods, or certain DOM nodes) across the Worker's boundaries via message passing or durable objects. To fix this, ensure you only send plain JavaScript objects and primitive data types between Workers. If you need to transfer complex data, serialize it into a JSON string before sending, and then deserialize it on the receiving end, or redesign your code to avoid sending such data in the first place.
Related Backend & Infra Packages
Production-Grade Container Scheduling and Management
Node.js JavaScript runtime ✨🐢🚀✨
Promise based HTTP client for the browser and node.js
A modern runtime for JavaScript and TypeScript.
Deliver web apps with confidence 🚀
Incredibly fast JavaScript runtime, bundler, test runner, and package manager – all in one
Subscribe to Updates
Get notified when new versions are released