DocsDigest
一覧へLanguage: EN
OpenAICloudflare Developer Platform2026/07/03 0:00

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

要点だけを先に読めるように短く再構成したセクションです。

元記事
OpenAIClaude

Quick Digest

要約

要点だけを先に読めるように短く再構成したセクションです。

openaijamodel: gpt-5-mini-2025-08-07

@cloudflare/workers-types v5：ランタイム型の簡素化

typescriptcloudflareworkerswranglertypesruntime

Key Points

  • 最新ランタイム型のみ公開
  • datedエントリを削除
  • wranglerで型を固定可能

Summary

@cloudflare/workers-types v5 が公開され、パッケージは最新のランタイム型のみを公開するよう簡素化されました。Worker 固有の互換日で型を固定するには引き続き wrangler types（Wrangler v4）で生成することを推奨します。パッケージを直接使う場合は以下の方法でインストールできます。

インストール例（開発依存）:

  • 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

Key Points

  • パッケージは最新互換日のランタイム型のみを公開
  • エントリポイントは @cloudflare/workers-types（最新安定互換）と @cloudflare/workers-types/experimental（実験的API）の2つ
  • @cloudflare/workers-types/2022-11-30 などの dated エントリは削除
  • 互換日で型を固定するには wrangler types（Wrangler v4）で生成する
  • 実務的には再現性を重視するなら wrangler で型を生成し、簡易確認や最新API利用はパッケージを直接利用する

Full Translation

翻訳

原文の流れを保ったまま読める翻訳セクションです。

openaijamodel: gpt-5-mini-2025-08-07

Workers — @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 のドキュメントや公式ページを参照してください。）