微信小程序学习Course 8 本地缓存API

微信小程序学习Course 8 本地缓存API

本篇随笔主要介绍微信小程序本地缓存API函数，微信小程序可以在本地缓存一些关键词数据，每一条关键词对应一段字符串。微信小程序提供了以下API函数。

8.1 同步存储与调用

wx.setStorageSync(string key, Object|string data)

其中key代表关键词；data代表一段字符串数据。只能是字符串。

Object|string wx.getStorageSync(string key)

其中key是关键词参数，返回值为一个字符串。

具体事例如下：

        wx.setStorageSync("DaysRemain", days1);
        wx.setStorageSync("Notice", days2);

　　

8.2 异步存储与调用

wx.getStorage(Object object)

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

其中object为一个对象，其具有以下内容

属性	类型	默认值	是否必填	说明	支持版本
key	string		是	本地缓存中指定的 key
success	function		否	接口调用成功的回调函数
fail	function		否	接口调用失败的回调函数
complete	function		否	接口调用结束的回调函数（调用成功、失败都会执行）

 其中success回调函数的res对象带有data数据，res.data

举例如下：

wx.getStorage({
      //获取数据的key
      key: 'key',
      success: function(res) {
        console.log(res)
        
      },
      /**
       * 失败会调用
       */
      fail: function(res) {
        console.log(res)
      }
    })

　　

wx.setStorage(Object object)

将数据存储在本地缓存中指定的 key 中，会覆盖掉原来该 key 对应的内容

其object对象如下:

属性	类型	默认值	是否必填	说明	支持版本
key	string		是	本地缓存中指定的 key
data	Object/string		是	需要存储的内容
success	function		否	接口调用成功的回调函数
fail	function		否	接口调用失败的回调函数
complete	function		否	接口调用结束的回调函数（调用成功、失败都会执行）

具体事例如下所示：

wx.setStorage({
      key: 'key',
      data: '我是storeage异步存储的信息',
      success: function(res) {
        console.log(res)
      }
    fail:function(res){
       console.log(res)
    } 
    })

　　

说明：同步异步的主要区别在于异步可以书写回调函数。

8.3 清除某关键词函数

wx.removeStorage(Object object)//异步清除，其object对象内容与之前一致。

wx.removeStorageSync(string key)//同步清除

8.4 清除所有缓存

wx.clearStorage(Object object)//异步清除

wx.clearStorageSync()//wx.clearStorage 的同步版本

8.5 获取所有信息

wx.getStorageInfo(Object object)

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

 其也对应有success函数、fail函数。成功后他会携带一个res入口对象，res具有以下属性。一则为key的数组。二则为大小；我们可以将key数据保存到一个数组中，如此就知道缓存中有什莫数据了。

属性	类型	说明	支持版本
keys	Array.<string>	当前 storage 中所有的 key
currentSize	number	当前占用的空间大小, 单位 KB
limitSize	number	限制的空间大小，单位 KB

Object wx.getStorageInfoSync()

wx.getStorageInfo 的同步版本

此函数返回值为一个对象，该对象具有的参数和上述一致。

 8.6 调试工具

在Debug界面有调试工具storage，我们可以通过观察storage的变化来检测数据的变化。

【小任务】

制作一个TODOlist实现备忘录功能，添加一个事件，就将此事件保存到本地数据中，事件我们存储在对象列表中，每一个事件包含：完成情况、事件描述。其他你可以自己增加。

点击此处查看作业解析

（本案例代码可以在博主github上查看）