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

概要

Cloudflare は @cloudflare/workers-types のバージョン 5 をリリースしました。 このリリースではパッケージを簡素化し、最新のランタイム型のみを公開します。引き続き wrangler types で Worker 用の型を生成することを推奨しますが、パッケージを直接利用する場合は、以下のパッケージマネージャーでインストールできます。

インストール

サポートされるパッケージマネージャー: npm, yarn, pnpm, bun

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

変更点（エントリポイント）

パッケージは現在、以下の 2 つのエントリポイントを公開しています。

• @cloudflare/workers-types
  • 最新の互換日（compatibility date）を反映し、最新の安定互換フラグを使用します。
• @cloudflare/workers-types/experimental
  • experimental な互換フラグの背後にある API を反映します。

以前のような日付付きエントリポイント（例: @cloudflare/workers-types/2022-11-30 や @cloudflare/workers-types/2023-03-01）は削除されました。

Wrangler を使ったランタイム型の生成

Wrangler v4 のランタイム型生成機能を使用すると、Worker の互換日に固定された型を作成できます。これには wrangler types コマンドを使用してください。

詳しくは TypeScript language support を参照してください。

補足

• パッケージを直接使う場合は、公開されている最新のランタイム型が使われるため、Worker の互換日を固定したい場合は wrangler types で明示的に型を生成することを推奨します。
• experimental API を利用する場合は @cloudflare/workers-types/experimental をインポートしてください。

---

（参考: Resources、API、サポート情報などの詳細は Cloudflare のドキュメントや公式ページを参照してください。）