手机淘宝8.8.0及以上版本支持该API,其他客户端请使用CanIUse判断相应版本是否支持此API。
将数据存储在本地缓存中指定的 key 中的异步接口,会覆盖掉原来该 key 对应的数据。支持内嵌 webview 的存储与小程序存储隔离,内嵌 webview 中指定key存储数据不会覆盖小程序自身相同 key 对应的数据。单条数据转换成字符串后,字符串长度最大为 200*1024。对于同一个淘宝用户的同一个小程序缓,存总上限为 10MB。
入参为 Object 类型,属性如下:
属性 |
类型 |
是否必须 |
描述 |
key |
String |
是 |
缓存数据的key |
data |
Object/String |
是 |
要缓存的数据 |
success |
Function |
否 |
调用成功的回调函数 |
fail |
Function |
否 |
调用失败的回调函数 |
complete |
Function |
否 |
调用结束的回调函数(调用成功、失败都会执行) |
my.setStorage({ key: 'currentCity', data: { cityName: '杭州', adCode: '330100', spell: ' hangzhou', }, success: function() { my.alert({content: '写入成功'}); } });
1、覆盖安装,不会导致小程序缓存失效;
2、设置中心清除缓存不会导致小程序缓存失效;
3、小程序缓存默认具有小程序id隔离。