• 下载
  • 社区

my.getStorage

获取缓存数据的异步接口。支持内嵌 webview 内缓与小程序缓存隔离,获取内嵌 webview 指定 key 的缓存不会同时返回小程序相同 key下的缓存数据。


扫码体验

缓存.jpeg


效果示例


getstorage.gif


示例代码

my.getStorage({
  key: 'currentCity',
  success: function(res) {
    my.alert({content: '获取成功:' + res.data.cityName});
  },
  fail: function(res){
    my.alert({content: res.errorMessage});
  }
});


入参

入参为 Object 类型,属性如下:

属性

类型

必填

描述

key

String

缓存数据的key。

success

Function

调用成功的回调函数。

fail

Function

调用失败的回调函数。

complete

Function

调用结束的回调函数(调用成功、失败都会执行)。


success 回调函数

入参为 Object 类型,属性如下:

属性

类型

说明

data

Object/String

key对应的内容。


其他信息

  • 缓存数据本地加密存储,通过 API 读取时会自动解密返回。
  • 覆盖安装支付宝(不是先删除再安装),不会导致小程序缓存失效;
  • 支付宝设置中心清除缓存不会导致小程序缓存失效;
  • 小程序缓存默认具有支付宝账号和小程序id两级隔离;
  • iOS 客户端支持 iTunes 备份。