缓存中间件

Cache 中间件使用 Web 标准的 Cache API。

Cache 中间件目前支持使用自定义域名的 Cloudflare Workers 项目和使用 Deno 1.26+ 的 Deno 项目。也可用于 Deno Deploy。

Cloudflare Workers 遵循 Cache-Control 标头并返回缓存的响应。有关详细信息，请参阅 Cloudflare 文档中的缓存。Deno 不遵循标头，因此如果需要更新缓存，则需要实现自己的机制。

请参阅下方的 用法 部分，以获取关于每个平台的说明。

导入

import { Hono } from 'hono'
import { cache } from 'hono/cache'

用法

Cloudflare Workers

app.get(
  '*',
  cache({
    cacheName: 'my-app',
    cacheControl: 'max-age=3600',
  })
)

Deno

// 必须为 Deno 运行时使用 `wait: true`
app.get(
  '*',
  cache({
    cacheName: 'my-app',
    cacheControl: 'max-age=3600',
    wait: true,
  })
)

选项

required cacheName: string | (c: Context) => string | Promise<string>

缓存的名称。可用于存储具有不同标识符的多个缓存。

optional wait: boolean

一个布尔值，指示 Hono 是否应等待 cache.put 函数的 Promise resolve 后再继续处理请求。Deno 环境中必须为 true。默认值为 false。

optional cacheControl: string

用于 Cache-Control 标头的指令字符串。有关更多信息，请参阅 MDN 文档。如果未提供此选项，则不会向请求添加 Cache-Control 标头。

optional vary: string | string[]

在响应中设置 Vary 标头。如果原始响应标头已包含 Vary 标头，则这些值将被合并，并删除任何重复项。将其设置为 * 将导致错误。有关 Vary 标头及其对缓存策略的影响的更多详细信息，请参阅 MDN 文档。

optional keyGenerator: (c: Context) => string | Promise<string>

为 cacheName 存储中的每个请求生成键。这可以用于基于请求参数或上下文参数缓存数据。默认为 c.req.url。