openaijamodel: gpt-5-mini-2025-08-07
Workers の fetch() が cf.vary をサポート
Key Points
- cf.vary に対応
- サブリクエストの Vary 制御
- accept / accept-language 正規化
Summary
Cloudflare Workers の fetch() で cf.vary リクエストオプションがサポートされました。これにより、単一のサブリクエストについて Vary ヘッダに基づく Cloudflare 側のキャッシュ挙動を細かく制御できます。JS/TS の両方で利用可能です。
例(要点): fetch(request, { cf: { vary: { default: { action: "bypass" }, headers: { accept: { action: "normalize", media_types: ["text/html","application/json"] }, "accept-language": { action: "normalize", languages: ["en","fr","de"] } } } } })
Key Points
- 使用目的: サブリクエストごとに Vary に基づくキャッシュの動作(正規化やバイパス)を設定するため。
- 設定例:
default.action=bypass(未指定時はオリジンフェッチ)、headersでaccept/accept-languageをnormalizeして media_types / languages を指定可能。 - 効果: ヘッダ正規化でキャッシュ断片化を減らし、必要に応じて特定サブリクエストをキャッシュ回避できる。
- 言語/型の例:
media_typesにtext/html/application/json、languagesにen/fr/deを指定するようなケース。 - 実践的アドバイス: サブリクエストで Vary を厳密に扱う必要がある場面(多言語やコンテンツネゴシエーション)で使用し、ステージングでキャッシュ挙動を検証する。
- 対応環境: JavaScript と TypeScript(型付きの例あり)。
参照: cf.vary オプションのドキュメントを確認して詳細な設定と副作用を確認してください。