Workers - Simpler runtime types with @cloudflare/workers-types v5

Summary

Cloudflare released @cloudflare/workers-types v5. The package is simplified to expose only the latest runtime types via two entrypoints: @cloudflare/workers-types (latest stable compatibility flags) and @cloudflare/workers-types/experimental (APIs behind experimental flags). Dated entrypoints (for specific compatibility dates) were removed — use wrangler types (Wrangler v4) to generate date-locked types for your Worker.

Key Points

• v5 exposes only the latest runtime types; dated entrypoints such as @cloudflare/workers-types/2022-11-30 are removed.
• Two entrypoints now available:
  • @cloudflare/workers-types — latest stable runtime types
  • @cloudflare/workers-types/experimental — experimental APIs behind flags
• If you need types locked to a Worker compatibility date, run Wrangler v4's wrangler types to generate them locally.
• Install the package (dev dependency) with your preferred package manager:

npm i -D @cloudflare/workers-types@latest
# or
yarn add -D @cloudflare/workers-types@latest
pnpm add -D @cloudflare/workers-types@latest
bun add -d @cloudflare/workers-types@latest

• Action items for engineers:
  • Replace dated imports with either the root entrypoint or generated types from wrangler types.
  • Use /experimental only when you expressly need experimental APIs and accept breaking/unstable changes.