OpenAICloudflare Developer Platform2026/06/28 0:00

Workers - Workers fetch requests now support cf.vary

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

元記事

Quick Digest

要約

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

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(未指定時はオリジンフェッチ)、headersaccept / accept-languagenormalize して media_types / languages を指定可能。
  • 効果: ヘッダ正規化でキャッシュ断片化を減らし、必要に応じて特定サブリクエストをキャッシュ回避できる。
  • 言語/型の例: media_typestext/html / application/jsonlanguagesen / fr / de を指定するようなケース。
  • 実践的アドバイス: サブリクエストで Vary を厳密に扱う必要がある場面(多言語やコンテンツネゴシエーション)で使用し、ステージングでキャッシュ挙動を検証する。
  • 対応環境: JavaScript と TypeScript(型付きの例あり)。

参照: cf.vary オプションのドキュメントを確認して詳細な設定と副作用を確認してください。

Full Translation

翻訳

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

翻訳はまだありません。

Workers - Workers fetch requests now support cf.vary | Cloudflare Developer Platform | DocsDigest