• 下载
  • 社区

my.setStorage

将数据存储在本地缓存中指定的 key 中的异步接口,会覆盖掉原来该 key 对应的数据。支持内嵌 webview 的存储与小程序存储隔离,内嵌 webview 中指定 key 存储数据不会覆盖小程序自身相同 key 对应的数据。单条数据转换成字符串后,字符串长度最大为 200*1024。对于同一个支付宝用户的同一个小程序总上限为 10MB。


说明

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


扫码体验

缓存.jpeg


效果示例

setstorage.gif


示例代码

my.setStorage({
  key: 'currentCity',
  data: {
    cityName: '杭州',
    adCode: '330100',
    spell: ' hangzhou',
  },
  success: function() {
    my.alert({content: '写入成功'});
  }
});


入参

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

属性

类型

必填

描述

key

String

缓存数据的 key。

data

Object/String

要缓存的数据。

success

Function

调用成功的回调函数。

fail

Function

调用失败的回调函数。

complete

Function

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