小程序文档整理之 -- API（数据缓存）

数据缓存

wx.setStorage(object)

将数据存储在本地缓存中指定的 key 中，会覆盖掉原来该 key 对应的内容，这是一个异步接口。

wx.setStorage({
  key:"key",//(必要)本地缓存中的指定的 key
  data:"value"//(必要)需要存储的内容
  success/fail/complete:function(){//接口调用成功/失败/结束的回调函数
  }
})

wx.setStorageSync(key, data)

将 data 存储在本地缓存中指定的 key 中，会覆盖掉原来该 key 对应的内容，这是一个同步接口。

 wx.setStorageSync(
  'key',//(必要)本地缓存中的指定的 key
  'value'//(必要)需要存储的内容
  )

wx.getStorage(object)

从本地缓存中异步获取指定 key 对应的内容

wx.getStorage({
  key: 'key',//(必要)本地缓存中的指定的 key
  success: function(res) {//(必要)接口调用成功的回调函数
      res.data//key对应的内容
  },
  fail/complete:function(){//接口调用失败/结束的回调函数
  }
})

wx.getStorageSync(key)

从本地缓存中同步获取指定 key 对应的内容

wx.getStorageSync('key')//（必要）参数key，本地缓存中的指定的 key

wx.getStorageInfo(object)

异步获取当前storage的相关信息

wx.getStorageInfo({
  success: function(res) {
    res.keys//当前storage中所有的key
    res.currentSize//当前占用的空间大小, 单位kb
    res.limitSize//限制的空间大小，单位kb
  },
  fail/complete:function(){//接口调用失败/结束的回调函数
  }
})

wx.getStorageInfoSync()

同步获取当前storage的相关信息

  var res = wx.getStorageInfoSync()
  console.log(res.keys)//当前storage中所有的key
  console.log(res.currentSize)//当前占用的空间大小, 单位kb
  console.log(res.limitSize)//限制的空间大小，单位kb

wx.removeStorage(object)

从本地缓存中异步移除指定 key

wx.removeStorage({
  key: 'key',//(必要)本地缓存中的指定的 key
  success: function(res) {//(必要)
    console.log(res.data)
  },
  fail/complete:function(){//接口调用失败/结束的回调函数
  }
})

wx.removeStorageSync(key)

从本地缓存中同步移除指定 key

 wx.removeStorageSync('key')//(必要)本地缓存中的指定的 key

wx.clearStorage()

清理本地数据缓存

wx.clearStorage()

wx.clearStorageSync()

同步清理本地数据缓存

wx.clearStorageSync()

注意：本地数据存储的大小限制为 10MB