my.setStorageSync

更新时间:2026/05/13 访问次数:1600

手机淘宝8.8.0及以上版本支持该API,其他客户端请使用CanIUse判断相应版本是否支持此API。


将数据存储在本地缓存中指定的 key 中的同步接口。

入参

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

属性

类型

是否必须

描述

key

String

缓存数据的key

data

Object/String

要缓存的数据要缓存的数据(注意:高性能容器只支持传入String类型

示例代码

// 普模式下使用示例
my.setStorageSync({
  key: 'currentCity',
  data: {
    cityName: '杭州',
    adCode: '330100',
    spell: ' hangzhou',
  }
});
// 高性能模式下使用示例
const city = {
  cityName: '杭州',
  adCode: '330100',
  spell: 'hangzhou',
};

my.setStorageSync({
  key: 'currentCity',
  data: JSON.stringify(city),   // 入参必须是 string
});

其他信息

1、覆盖安装,不会导致小程序缓存失效;

2、设置中心清除缓存不会导致小程序缓存失效;

3、小程序缓存默认具有小程序id隔离;

FAQ

关于此文档暂时还没有FAQ
返回
顶部