将数据存储在本地缓存中指定的 key 中。会覆盖掉原来该 key 对应的内容。除非用户主动删除或因存储空间原因被系统清理,否则数据都一直可用。单个 key 允许存储的最大数据长度为 1MB,所有数据存储上限为 10MB。

参考文档

类型

  1. (option: Option) => Promise<CallbackResult>

参数

Option

参数类型必填说明
dataany需要存储的内容。只支持原生类型、Date、及能够通过JSON.stringify序列化的对象。
keystring本地缓存中指定的 key
complete(res: CallbackResult) => void接口调用结束的回调函数(调用成功、失败都会执行)
fail(res: CallbackResult) => void接口调用失败的回调函数
success(res: CallbackResult) => void接口调用成功的回调函数

示例代码

  1. Taro.setStorage({
  2. key:"key",
  3. data:"value"
  4. })
  1. try {
  2. Taro.setStorageSync('key', 'value')
  3. } catch (e) { }

API 支持度

API微信小程序H5React Native
Taro.setStorage✔️✔️✔️