- 投稿日
@cloudflare/workers-types の Compatibility dates を知っているか
Cloudflare Workers で TypeScript を使う際に、@cloudflare/workers-types という型定義パッケージを使う。
Cloudflare Workers には Compatibility dates という概念がある。これは後方互換性を保つためにある。
通常これは wrangler.toml に記述することで Cloudflare Workers ランタイムのバージョンをプロジェクトで指定できる。
筆者は今日まで知らなかったが、@cloudflare/workers-types にも Compatibility dates がある。
@cloudflare/workers-types - npm
TypeScript typings for Cloudflare Workers. Latest version: 4.20250614.0, last published: 19 hours ago. Start using @cloudflare/workers-types in your project by running `npm i @cloudflare/workers-types`. There are 180 other projects in the npm registry using @cloudflare/workers-types.
ここの Compatibility dates には、現在 @cloudflare/workers-types で設定できる Compatibility dates が記載されている。筆者が特に気になったのはこれらの記述である。
@cloudflare/workers-typesよくブログや記事で見かける書き方であるが、これは最新のバージョンを指定してくれているわけではなく、
2021-11-03よりも前の互換性を保証しているということである。
@cloudflare/workers-types/experimentalこれは最新の Cloudflare Workers ランタイムに追従した型定義である。プロダクションなどで使う際には注意が必要である。
みんな困っていないのだろうか...