本地存储

案例分析

• app.js - 启动时 onLaunch 拉取本地缓存的日志记录

const logs = wx.getStorageSync('logs') || []
logs.unshift(Date.now())
wx.setStorageSync('logs', logs)

• log.js - 拉取并处理|格式化日志

this.setData({
    logs: (wx.getStorageSync('logs') || []).map(log => {
        return {
            date: util.formatTime(new Date(log)),
            timeStamp: log
        }
    })
})

简介

• 以值对 key-value 的形式在客户端永久保存数据
• 单个 key 允许存储的最大数据长度为 1MB，所有数据存储上限为 10MB
• 保存的数据 data|value：只支持原生类型、Date、及能够通过 JSON.stringify 序列化的对象
• 应：只进行数据的持久化存储，不应：用于运行时的数据传递或全局状态管理。启动过程中过多的同步读写存储，会显著影响启动
• 更多本地缓存，可以访问 HTML localStorage

查看

• 所有的 API 都支持同步调用或异步调用
• 异步调用的 API 以 Sync 结束

本地存储 API

同步	异步
wx.setStorage	wx.setStorageSync
wx.getStorage	wx.getStorageSync
wx.removeStorage	wx.removeStorageSync
wx.clearStorage	wx.clearStorageSync

保存数据 set

1. wx.setStorage(Object object)
2. wx.setStorageSync(string key, any data)

. 保存的时候，必须指定 key 和 data

. 保存成功，返回 errMsg: "setStorage:ok"

wx.setStorage({
    key:'msg',
    data:'hi, there.',
    success:res=>console.log(res),
    fail:err=>console.log(err),
    complete:()=>console.log('set done log')
})

获取数据 get

1. wx.getStorage(Object object)
2. wx.getStorageSync(string key)

获取的时候，必须指定 key

如果成功，在返回结果的 data 中解析数据

如果数据不存在，返回 errMsg: "getStorage:fail data not found"

wx.getStorage({
    key:'msg',
    success:res=>console.log(res),
    fail:err=>console.log(err),
    complete:()=>console.log('get done log')
})

建议获取数据 get，使用同步调用，减少异步操作带来的性能损耗

.如果数据不存在，返回字符串 hi

getMsgSync() {
    let msg = wx.getStorageSync('msg') || 'hi'
    this.setData({
        msg: msg
    })
}

.如果数据不存在，返回对象 {id:100,name:'glpla'}

getMsgSync() {
    let msg = wx.getStorageSync('msg') || {id:100,name:'glpla'}
    this.setData({
        msg: msg
    })
}

.如果数据不存在，返回数组 [0, 1, 2, 3, 4]

getMsgSync() {
    let msg = wx.getStorageSync('msg') || [0, 1, 2, 3, 4]
    this.setData({
        msg: msg
    })
}

删除指定数据 remove

1. wx.removeStorage(Object object)
2. wx.removeStorageSync(string key)

删除的时候，必须指定 key

删除成功，返回 errMsg: "removeStorage:ok"

wx.removeStorage({
    key: 'msg',
    success:res=>console.log(res),
    fail:err=>console.log(err),
    complete:()=>console.log('remove done log')
})

清除所有数据 clear

1. wx.clearStorage(Object object)
2. wx.clearStorageSync()

清除成功，返回 errMsg: "clearStorage:ok"

wx.clearStorage({
    success:res=>console.log(res),
    fail:err=>console.log(err),
    complete:()=>console.log('clear done log')
})

wx.setStorage({
    key: 'obj',
    data: {id:100,name:'glpla'},
    success: res => console.log('set',res),
    fail: err => console.log('set',err),
    complete: () => console.log('set done')
})

let obj = wx.getStorageSync('obj') || {id:100,name:'glpla'}