小程序缓存管理器CacheManager

CacheManager

缓存管理器。全局只有唯一实例,一旦被创建出来即表示接入缓存管理器。其有以下几个能力:

基础库 2.23.0 开始支持,低版本需做兼容处理。
  1. 在网络通畅时,符合一定规则的用户网络请求(目前只包括普通 wx.request 请求)会被缓存。
  2. 在网络通畅时,某些 wx api 调用会被缓存。
  3. 进入弱网/离线状态时,会提供事件给用户,用户可以决定是否使用缓存返回。
  4. 提供进入和退出弱网/离线状态的事件。
  1. 缓存管理器中涉及的网络请求如无特指,均指普通的 wx.request 异步请求,参数和返回值中均不考虑涉及 ArrayBuffer 或 TypedArray 的情形。
  2. 缓存管理器中的缓存不会占用 storage 空间,但是有大小限制,请勿在非必要的请求上使用缓存。

属性

string mode

当前缓存模式

mode 的合法值

说明 最低版本
weakNetwork 默认值,弱网/离线使用缓存返回
always 总是使用缓存返回
none 不开启,后续可手动开启/停止使用缓存返回

string origin

全局 origin

string maxAge

全局缓存有效时间

number state

当前缓存管理器状态

state 的合法值

说明 最低版本
0 不使用缓存返回
1 使用缓存返回
2 未知

方法

Array.string CacheManager.addRules(Array.(string|RegExp|Object) rules)

批量添加规则,规则写法可参考 CacheManager.addRule

string CacheManager.addRule(string|RegExp|Object rule)

添加规则。

CacheManager.deleteRules(Array.string ids)

批量删除规则,同时会删除对应规则下所有缓存。

CacheManager.deleteRule(string id)

删除规则,同时会删除对应规则下所有缓存。

CacheManager.clearRules()

清空所有规则,同时会删除对应规则下所有缓存。

CacheManager.on(string eventName, function handler)

监听事件。

CacheManager.off(string eventName, function handler)

取消事件监听。

CacheManager.start()

开启缓存,仅在 mode 为 none 时生效,调用后缓存管理器的 state 会置为 1。

CacheManager.stop()

关闭缓存,仅在 mode 为 none 时生效,调用后缓存管理器的 state 会置为 0。

Object CacheManager.match(Object evt)

匹配命中的缓存规则,一般需要和 request 事件搭配使用。

CacheManager.deleteCaches(Array.string ids)

批量删除缓存。

CacheManager.deleteCache(string id)

删除缓存。

CacheManager.clearCaches()

清空所有缓存。

分类小程序缓存管理器相关推荐:

小程序创建缓存管理器wx.createCacheManager 小程序缓存管理器CacheManager 小程序缓存管理批量添加规则CacheManager.addRules 小程序缓存管理添加规则CacheManager.addRule 小程序缓存管理批量删除规则CacheManager.deleteRules 小程序缓存管理删除规则CacheManager.deleteRule 小程序缓存管理清空所有规则CacheManager.clearRules 小程序缓存管理监听事件CacheManager.on 小程序缓存管理取消事件监听CacheManager.off 小程序缓存管理开启缓存CacheManager.start 小程序缓存管理关闭缓存CacheManager.stop 小程序缓存管理匹配缓存规则CacheManager.match 小程序缓存管理批量删除缓存CacheManager.deleteCaches 小程序缓存管理删除缓存CacheManager.deleteCache 小程序缓存管理清空所有缓存CacheManager.clearCaches