Cloudflare Workers
Backend & Infra⛅️ Home to Wrangler, the CLI for Cloudflare Workers®
Release History
@cloudflare/deploy-helpers@0.1.01 featureThis minor release introduces a new internal package, @cloudflare/deploy-helpers, containing shared types and code for deployment operations.
@cloudflare/vitest-pool-workers@0.16.91 fix2 featuresThis patch updates dependencies and significantly shrinks the published bundle size by correctly deriving bundler externals from package.json and improving tree-shaking.
@cloudflare/vite-plugin@1.38.01 featureThis release introduces QR code generation for Cloudflare Tunnel URLs during local development for improved mobile accessibility. It also includes dependency updates for Wrangler and Miniflare.
@cloudflare/pages-shared@0.13.139This patch release primarily consists of dependency updates, specifically upgrading miniflare to version 4.20260521.0.
@cloudflare/cli-shared-helpers@0.1.4This patch release primarily involved updating internal dependencies, specifically @cloudflare/workers-utils to version 0.21.1.
@cloudflare/workers-utils@0.21.11 fix2 featuresThis patch improves tree-shaking for @cloudflare/workers-utils by marking it as side-effect-free and correctly declares undici as a runtime dependency, fixing unresolved import issues.
wrangler@4.94.02 fixes3 featuresThis release introduces groundwork for scheduled Workflow triggering via cron expressions in bindings and improves local development by adding QR codes for tunnels and fixing Access Service Token authentication issues. Wrangler also now supports automatic installation of AI coding agent skills.
miniflare@4.20260521.01 fixThis patch release updates dependencies, including workerd, and fixes an issue where TCP requests failed when an outboundService was configured.
@cloudflare/containers-shared@0.15.11 fixThis patch release improves local development cleanup by ensuring sibling container image tags are preserved when multiple containers share a Dockerfile.
@cloudflare/pages-shared@0.13.1381 fixThis patch release fixes an issue where relative link hrefs were not correctly resolved against the document's base href during early hint Link header generation. Dependencies, including miniflare, were also updated.
@cloudflare/vitest-pool-workers@0.16.82 fixesThis patch fixes an inconsistency in how the CF-Worker header is generated during local development, ensuring it correctly reflects the parent zone name as it does in production. Dependencies including miniflare and wrangler have also been updated.
miniflare@4.20260520.03 fixesThis patch primarily addresses security vulnerabilities by updating the `ws` dependency and improves local development reliability by enhancing error reporting and adding self-healing for the Browser Run binding cache. It also corrects an issue with host validation for cdn-cgi routes in Miniflare.
@cloudflare/vite-plugin@1.37.33 fixesThis patch primarily addresses security concerns by updating the `ws` dependency and fixes several bugs related to host validation and the `CF-Worker` header generation during local development.
@cloudflare/workflows-shared@0.11.02 featuresThis release introduces rollback support for local Workflows development, enabling steps to define compensation callbacks that execute upon workflow failure. Rollback configuration is passed via new options to `step.do`.
wrangler@4.93.15 fixesThis patch primarily addresses security vulnerabilities by updating the `ws` dependency and fixes several inconsistencies in local development environments related to host validation and the `CF-Worker` header. It also improves authentication token precedence and error reporting in Wrangler.
wrangler@4.93.06 fixes3 featuresThis release introduces new commands for querying the Workers AI model catalog (`ai models schema` and `ai models list`) and adds deployment control via `--containers-rollout=none`. Several bug fixes address issues related to D1 migrations, local Workflow startup, and cleanup of temporary files.
miniflare@4.20260518.01 fix1 featureThis release updates dependencies, including workerd, and introduces support for `using` and `await using` keywords in script parsing via Miniflare updates. A bug preventing local Workflow startup with the experimental flag is also resolved.
create-cloudflare@2.68.3This patch release primarily updates various dependencies within the "create-cloudflare" tooling, including updates to create-vite, nuxi, and Angular related packages.
@cloudflare/containers-shared@0.15.0Breaking1 fix1 featureThis release introduces the `--containers-rollout=none` flag for deployment control and refactors an internal Docker verification utility for better readability and extensibility.
@cloudflare/vitest-pool-workers@0.16.71 fixThis patch primarily fixes an issue where dynamically wrapped RPC methods could invoke out of order for Workers and Durable Objects. Dependencies including wrangler and miniflare have also been updated.
@cloudflare/pages-shared@0.13.137This patch release primarily consists of dependency updates, specifically upgrading miniflare to version 4.20260518.0.
@cloudflare/vite-plugin@1.37.21 fixThis patch release fixes an issue where WebSocket upgrade requests were not routed correctly in development mode and updates underlying dependencies.
miniflare@4.20260515.0This patch release updates dependencies for "miniflare" and "wrangler", specifically updating the bundled workerd version.
wrangler@4.92.05 fixes2 featuresThis release introduces CLI support for managing Cloudflare Artifacts via new `wrangler artifacts` commands and adds the `--keep-vars` flag to `wrangler versions upload`. Several critical bugs related to authentication token refreshing and URL query string manipulation in `wrangler dev` have also been resolved.
@cloudflare/pages-shared@0.13.136This patch release primarily updates internal dependencies, specifically upgrading miniflare to version 4.20260515.0.
@cloudflare/vite-plugin@1.37.11 fix1 featureThis patch updates dependencies and enhances the Cloudflare Vite plugin to honor the X-Forwarded-Proto header for correct request URL construction in proxied environments, and adds a tunnel shortcut hint to CLI output.
@cloudflare/vitest-pool-workers@0.16.61 fixThis patch release updates dependencies, including Miniflare and Wrangler, and filters noisy WebSocket disconnection messages during testing.
@cloudflare/devprod-status-bot@1.5.01 featureThis minor release introduces enhanced issue tracking by automatically posting Chat alerts to a dedicated webhook for issues tagged with the "api" label.
miniflare@4.20260511.01 featureThis patch updates the underlying workerd dependency and introduces header propagation for trace IDs in remote binding proxy requests.
@cloudflare/vite-plugin@1.37.01 featureThis release introduces named Cloudflare Tunnel support for the Vite plugin and updates underlying dependencies including Wrangler and Miniflare.
@cloudflare/pages-shared@0.13.135This patch release primarily involves updating dependencies, specifically bumping miniflare to version 4.20260511.0.
@cloudflare/vitest-pool-workers@0.16.5This patch release primarily focuses on updating internal dependencies, specifically upgrading wrangler to version 4.91.0 and miniflare to version 4.20260511.0.
wrangler@4.91.05 fixes3 featuresThis release introduces named tunnel support for stable local development hostnames via `wrangler dev`. It also includes several bug fixes, such as normalizing instance type aliases and ensuring worker preview bindings match deployment behavior for non-string variables.
wrangler@4.90.14 fixesThis patch release focuses on stability fixes, particularly addressing issues in `wrangler dev` related to hotkey cleanup during shutdown and ensuring remote binding updates complete before subsequent operations. Dependencies, including workerd, have also been updated.
@cloudflare/workers-shared@0.19.6This patch temporarily hardcodes the asset worker cohort to "ent" for latency testing, disabling the cohort-based version routing in the outer entrypoint.
@cloudflare/vite-plugin@1.36.41 fixThis patch release updates the bundled Vite module runner to incorporate a critical bug fix from Vite. It also updates dependencies including miniflare and wrangler.
@cloudflare/vitest-pool-workers@0.16.4This patch release primarily updates internal dependencies, specifically upgrading miniflare to version 4.20260508.0 and wrangler to version 4.90.1.
create-cloudflare@2.68.2This patch release primarily updates various dependencies within the "create-cloudflare" tooling, including updates to create-vike, sv, Angular create, create-react-router, @tanstack/create-start, create-next-app, and create-waku.
@cloudflare/pages-shared@0.13.134This patch release primarily involves updating dependencies, specifically upgrading miniflare to version 4.20260508.0.
miniflare@4.20260508.01 featureThis release introduces support for configuring workerd autogates via an environment variable and updates internal dependencies, including workerd.
@cloudflare/devprod-status-bot@1.4.21 featureThe status bot's message generation has been migrated from the deprecated Llama 2 7B chat model to the Gemma 4 model.
@cloudflare/cli-shared-helpers@0.1.3This patch release primarily involved updating dependencies, specifically upgrading @cloudflare/workers-utils to version 0.21.0.
@cloudflare/vite-plugin@1.36.3This patch release updates the bundled dependencies wrangler and miniflare to their latest versions.
@cloudflare/vitest-pool-workers@0.16.3This patch release updates the bundled dependencies for wrangler and miniflare to newer versions.
@cloudflare/workers-utils@0.21.0This release introduces a deprecation warning for the unused `delivery_delay` setting in queue producer bindings, directing users to use `wrangler queues update` for configuration.
wrangler@4.90.02 fixesThis release introduces a deprecation warning for the unused `delivery_delay` setting in queue producer bindings and fixes bugs related to account token authentication and Containers SSH configuration.
miniflare@4.20260507.11 fix1 featureThis patch improves the hosted images mock for local development by ensuring variant URLs in ImageMetadata point to a functional local delivery endpoint, fixing issues with image rendering during local testing.
@cloudflare/pages-shared@0.13.133This patch release primarily updates internal dependencies, specifically upgrading miniflare to version 4.20260507.1.
@cloudflare/vitest-pool-workers@0.16.21 featureThis patch introduces the ability to import .wasm files as modules using the .wasm?module syntax and updates underlying dependencies.
wrangler@4.89.11 fixThis patch release fixes a bug where container deployment was incorrectly skipped for Workers for Platforms user workers using --dispatch-namespace. Dependencies were also updated.
@cloudflare/vite-plugin@1.36.2This patch release primarily consists of dependency updates for wrangler and miniflare.
wrangler@4.89.05 fixes2 featuresThis release introduces configurable HTTP caching for Workers and standardizes local development timezone to UTC to match production environments. Several bugs related to asset bindings in previews, type checking, and authentication listing were also resolved.
@cloudflare/vite-plugin@1.36.11 fixThis patch release fixes a bug related to quote handling in `.dev.vars` files generated during `vite preview` and updates several dependencies, including miniflare and wrangler.
@cloudflare/vitest-pool-workers@0.16.1This patch release primarily focuses on updating internal dependencies, specifically upgrading miniflare to version 4.20260507.0 and wrangler to version 4.89.0.
miniflare@4.20260507.01 fix3 featuresThis release enhances the Email Sending API with support for named recipients in the MessageBuilder and aligns Miniflare's local development environment timezone with production by defaulting workerd to UTC.
@cloudflare/workers-utils@0.20.02 featuresThis release introduces a new `cache` configuration option in Wrangler to enable HTTP caching for Workers fetch handlers, with specific support for preview deployments.
@cloudflare/cli-shared-helpers@0.1.2This patch release primarily involves updating internal dependencies, specifically @cloudflare/workers-utils to version 0.20.0.
@cloudflare/pages-shared@0.13.132This patch release primarily involves updating dependencies, specifically upgrading miniflare to version 4.20260507.0.
@cloudflare/vite-plugin@1.36.01 fix2 featuresThis release stabilizes the 'secrets' configuration property in Wrangler, adding validation for required secrets, and enhances security by preventing the Vite dev server from fetching credential files.
wrangler@4.88.05 fixes5 featuresThis release stabilizes the `secrets` configuration, enhances `wrangler deploy` with interactive prompts for missing configuration, and introduces support for `builtin` AI Search instances and custom metadata.
@cloudflare/cli-shared-helpers@0.1.1This patch release primarily involved updating internal dependencies, specifically @cloudflare/workers-utils to version 0.19.0.
@cloudflare/workers-utils@0.19.02 featuresThis minor release stabilizes the `secrets` configuration property in Wrangler, enhancing validation during development and deployment.
@cloudflare/workers-shared@0.19.51 fixThis patch introduces logic during deployment to route asset-worker requests based on account plans and adds validation to reject invalid `_headers` rules containing multiple wildcards or wildcard/:splat combinations.
miniflare@4.20260504.03 fixesThis patch release primarily updates internal dependencies, including workerd, and fixes a critical race condition affecting Browser Run on Windows when launching Chrome.
create-cloudflare@2.68.1This patch release primarily updates various dependencies within the "create-cloudflare" tooling, including updates for @tanstack/create-start, create-waku, create-docusaurus, and @angular/create.
@cloudflare/vitest-pool-workers@0.16.01 fix2 featuresThis release stabilizes the 'secrets' configuration property and fixes an issue where self-referencing service bindings broke due to runner worker renaming during testing.
@cloudflare/pages-shared@0.13.131This patch release primarily focused on updating internal dependencies, specifically upgrading miniflare to version 4.20260504.0.
@cloudflare/vite-plugin@1.35.01 featureThis release introduces support for the V2 protocol for module fallback service when the new module registry flag is enabled. It also includes internal refactoring of the router-worker for future gradual rollout.
wrangler@4.87.0Breaking2 fixes2 featuresThis release enforces Node.js 22 as the minimum required version and introduces an experimental programmatic API for generating Worker types. It also fixes deployment logic when using explicit configuration flags and improves asset directory handling for development proxies.
@cloudflare/workers-shared@0.19.4The router-worker has been refactored to separate invocation from business logic, preparing for future gradual rollouts based on user plans, but resulting in no immediate functional change.
@cloudflare/workflows-shared@0.10.01 featureIntroduced a new feature allowing developers to restart local Workflows execution from a specified step, leveraging cached results from preceding steps for faster iteration.
create-cloudflare@2.68.0BreakingThis release enforces a minimum Node.js version of 22, dropping support for Node.js 20.x, and includes several minor dependency updates within create-cloudflare.
miniflare@4.20260430.0Breaking3 fixes4 featuresThis release enforces a minimum Node.js version of 22, introduces local restart support for Workflows, and fixes several local development issues related to Hyperdrive connections and data serialization.
@cloudflare/vitest-pool-workers@0.15.2This patch release primarily focuses on updating underlying dependencies, specifically miniflare and wrangler, to their latest versions.
@cloudflare/kv-asset-handler@0.5.0BreakingWrangler has dropped support for Node.js 20.x, enforcing a minimum requirement of Node.js 22.0.0.
@cloudflare/pages-shared@0.13.130This patch release primarily updates dependencies, including an update to miniflare to version 4.20260430.0.
@cloudflare/vitest-pool-workers@0.15.1This patch release primarily focuses on updating internal dependencies, specifically upgrading wrangler to version 4.86.0 and miniflare to version 4.20260426.0.
@cloudflare/workers-shared@0.19.31 fixThis patch release fixes a TypeError in the router-worker when static routing is configured without user worker rules. The fix ensures proper iteration handling in the static routing matcher.
create-cloudflare@2.67.4This patch release primarily updates various dependencies within the "create-cloudflare" tooling, including updates to create-vite, create-react-router, create-analog, and others.
@cloudflare/vite-plugin@1.34.01 fix3 featuresThis release introduces the ability to share local development and preview servers publicly using Cloudflare Quick Tunnels via a new `tunnel: true` option in the Vite plugin. Dependencies have also been updated.
@cloudflare/local-explorer-ui@0.13.32 fixes1 featureThis patch release focuses on improving the user experience of the instance page and fixing a bug where expanded workflow steps were incorrectly collapsing during polling.
wrangler@4.86.0Breaking3 fixes5 featuresThis release enhances CLI tooling with namespace support for AI Search, public sharing via Quick Tunnels in `wrangler dev`, and improved queue consumer listing. It also enforces remote access for Flagship bindings during local development.
miniflare@4.20260426.05 fixes1 featureThis release enhances local development by adding extended SSL mode support for Hyperdrive and forcing Flagship bindings to use remote services locally. Several bugs were fixed related to multi-worker setups, service binding props forwarding, and router-worker stability.
@cloudflare/pages-shared@0.13.129This patch release primarily consists of dependency updates, specifically upgrading miniflare to version 4.20260426.0.
@cloudflare/pages-shared@0.13.128This patch release primarily updates dependencies, including an update to miniflare to version 4.20260424.0.
@cloudflare/vite-plugin@1.33.22 fixes2 featuresThis patch release updates dependencies, improves Vite plugin local development by supporting Cloudflare registry images, and fixes the default compatibility date fallback behavior.
@cloudflare/vitest-pool-workers@0.15.02 featuresThis release introduces new testing utilities, `reset()` and `abortAllDurableObjects()`, to `cloudflare:test` for better state management in tests. It also includes dependency updates for wrangler and miniflare.
miniflare@4.20260424.02 fixes5 featuresThis release introduces local video serving capabilities, stable stream preview URLs via `publicUrl`, and fixes reliability issues with the dev registry watcher on Windows. Caption uploads via ReadableStream are also now supported locally.
create-cloudflare@2.67.3This patch updates internal dependencies, specifically bumping `@clack/core` and `@clack/prompts` to version 1.2.0 within the CLI tools.
wrangler@4.85.05 fixes1 featureThis release introduces support for enabling/disabling production and preview traffic for custom domain routes and significantly improves error reporting when API requests are blocked by the Cloudflare WAF. Dependency updates for workerd and clack were also performed.
@cloudflare/cli-shared-helpers@0.1.01 featureThis release publishes the internal packages @cloudflare/cli-shared-helpers and @cloudflare/workers-utils to npm, updating the latter to version 0.18.0.
@cloudflare/containers-shared@0.14.11 fix1 featureThis patch introduces support for Cloudflare-managed registry images in the Vite plugin local development environment, resolving a crash when using `registry.cloudflare.com` images in container bindings.
@cloudflare/workflows-shared@0.9.11 fixThis patch release focuses on improving error handling by preserving the original message and name for NonRetryableError when the relevant compatibility flag is active.
@cloudflare/pages-shared@0.13.127This patch release primarily involves updating dependencies, specifically upgrading miniflare to version 4.20260421.0.
miniflare@4.20260421.01 fixThis patch updates the bundled workerd dependency and resolves numerous sourcemap warnings present in miniflare when used within pnpm monorepos.
wrangler@4.84.11 fixThis patch release updates dependencies, including workerd, and fixes a bug in `wrangler types --check` related to environment interface and configuration resolution.
@cloudflare/vitest-pool-workers@0.14.9This patch release updates underlying dependencies, specifically miniflare and wrangler, to newer versions.
create-cloudflare@2.67.21 featureThis patch release updates the design of the React Workers starter template to match the latest Vite React upstream design.
@cloudflare/local-explorer-ui@0.13.24 fixesThis patch release focuses on refining the Local Explorer UI, including improvements to D1 table selection and better handling of R2 empty states and navigation.
@cloudflare/vite-plugin@1.33.1This patch release updates underlying dependencies, specifically miniflare and wrangler, to newer versions.
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