Cache
说明：
缓存的内容仅在当前数据节点有效，不会自动复制到其他数据节点。
构造函数
使用
caches.default 可以获取默认的 cache 实例。// 获取默认 cache 实例const cache = caches.default;// 效果等同于 caches.defaultawait caches.open('default');
使用
caches.open 创建指定命名空间的 cache 实例。// 创建指定命名空间的 cache 实例const cache = await caches.open(namespace);
参数
caches.open(namespace) 方法参数说明如下。参数名称 | 类型 | 必填 | 说明 |
namespace | string | 是 | 缓存命名空间。 如果该值为 "default" 则表示默认实例，也可直接使用 caches.default 获取默认实例。 |
实例方法
match
cache.match(request: string | Request, options?: MatchOptions): Promise<Response | undefined>
注意：
cache.match 内部不会主动回源，缓存过期则会抛出 504 错误。
参数
参数名称 | 类型 | 必填 | 说明 |
request | string | Request | 是 | 请求对象，headers 说明如下。 GET request 只支持 GET 方法，当类型为 string 时，将被作为 URL 构造 Request 对象。 Range request 包含 Range 头部时，如果缓存的 Response 能够支持 Range 范围处理，返回 206 响应。 If-Modified-Since request 包含 If-Modified-Since 头部时，如果缓存的 Response 存在 Last-Modified 头部，且 Last-Modified 与 If-Modified-Since 相等，返回 304 响应。 If-None-Match |
options | 否 | 选项。 |
MatchOptions
属性名 | 类型 | 示例值 | 说明 |
ignoreMethod | boolean | true | 是否忽略 Request 的 method。为 true 时，会忽略 Request 原来的 method，作为 GET 处理。 |
put
cache.put(request: string | Request, response: Response): Promise<undefined>
尝试使用给定的 request 作为缓存 key，将 response 添加到缓存。无论缓存是否成功，均返回
Promise<undefined> 对象。注意：
当参数 response 对象的 Cache-Control 头部表示不缓存时，抛出 413 错误。
参数
参数名称 | 类型 | 必填 | 说明 |
request | string | Request | 是 | 缓存 key，说明如下。 GET 参数 request 仅支持 GET 方法，其他方法，将抛出参数错误。 string |
response | 是 | 缓存内容，说明如下。 Cache-Control 支持 s-maxage、max-age、no-store、no-cache、private；其中 no-store、no-cache、private 均表示不缓存，cache.put 将返回 413 错误。 Pragma ETag Last-Modified 416 Range Not Satisfiable |
参数限制
cache.put 使用以下的参数值，将抛出参数错误：参数
request 为 GET 方法之外的其他方法.参数
response 状态码为 206 Partial Content。 参数
response 包含 Vary: *头部。delete
cache.delete(request: string | Request, options?: DeleteOptions): Promise<boolean>
删除 request 关联的缓存 response。未发生网络错误时, 总返回 Promise，并包含 true，反之包含 false。
参数
参数名称 | 类型 | 必填 | 说明 |
request | string | Request | 是 | 缓存 key，说明如下。 GET 参数 request 仅支持 GET 方法 string |
options | 否 | 配置选项。 |
DeleteOptions
属性名 | 类型 | 示例值 | 说明 |
ignoreMethod | boolean | true | 是否忽略 request 的方法名。为 true 时，会忽略 Request 原来的方法，作为 GET 处理 |