说明

• value目前只支持字符串类型

  1. Storage JSAPI简介

  Storage JSAPI是一个轻量级数据存储接口，特别适用于存储应用的各项数据。
  例如在天气应用中，在某一次使用时用户添加了若干个城市，当用户下一次点开时也希望之前设置的城市会保存在应用中，以方便直接获取信息。又如在屏保设置选项里，用户设置了打开屏保，当设备下次开机时也需要记住用户的选项，将屏保打开。这时就需要借助于Storage JSAPI，利用它来存储一些键值对(Key-Value)参数。

Storage JSAPI的作用域为当前小程序应用，包含的接口如下：

1.1 setStorage

保存key-value数据
入参
Object 类型，属性如下：

示例代码

// 异步方法
const storage = $falcon.jsapi.storage;
storage.setStorage({
  key: 'key',                             // key
  data: 'storage content',    // value
}, result => {result && !result.error && console.log('save success: ', result);});
// 同步方法
const storage = $falcon.jsapi.storage;
let result = await storage.setStorage({
  key: 'key',                             // key
  data: 'storage content',    // value
});           
result && !result.error && console.log('save success: ', result);

success 回调函数

1.2 getStorage

读取key-value数据
入参
Object 类型，属性如下：

示例代码

const storage = $falcon.jsapi.storage;
storage.getStorage({
  key: 'key'         // key
}, result => {
    result && !result.error && console.log('dialog clicked ', result);
});

success 回调函数

1.3 removeStorage

删除当前小程序指定key所对应的value数据
入参
Object 类型，属性如下：

示例代码

const storage = $falcon.jsapi.storage;
storage.removeStorage({
  key: 'key'         // key
}, result => {result && !result.error && console.log('dialog clicked ', result);});

success 回调函数

1.4 clearStorage

清空当前小程序所有的key-value数据
入参
Object 类型，属性如下：

示例代码

const storage = $falcon.jsapi.storage;
storage.clearStorage({
}, result => {result && !result.error && console.log('dialog clicked ', result);});

success 回调函数

1.5 getStorageInfo

获取当前小程序所有的key数据，将返回所有通过setStorage接口存储的key数据
入参
Object 类型，属性如下：

示例代码

const storage = $falcon.jsapi.storage;
storage.getStorageInfo({
}, result => {result && !result.error && console.log('dialog clicked ', result);});

success 回调函数

2. Storage JSAPI使用教程

2.1 storage对象获取

在使用Storage JSAPI前，需要先获取$falcon.jsapi的storage对象，所有的接口都是通过storage对象进行调用的。

const storage = $falcon.jsapi.storage;

2.2 数据存储

数据存储操作需要通过步骤1获取的storage对象来进行，具体可通过storage.setStorage来实现键值对参数的存储，可存储的数据类型有Bool、Float、Int、Long、String五种。

在进行数据存储时，有两种方式，一种是同步存储，另一种是异步存储。同步存储直接返回存储结果，通过await返回存储结果，异步存储需要在async函数中操作。

异步存储方式：

// async
const storage = $falcon.jsapi.storage;
storage.setStorage({
  key: 'key',               // key
  data: 'storage content',  // value
}, result => {});

同步存储方式：

// sync
const storage = $falcon.jsapi.storage;
let result = await storage.setStorage({
  key: 'key',               // key
  data: 'storage content',  // value
});
console.log(result);

2.3 数据读取

数据读取操作也需要通过步骤1获取的storage对象来进行，具体可通过storage.getStorage来实现键值对参数的读取，可读取的数据类型有Bool、Float、Int、Long、String五种。

在进行数据读取时，也有两种方式，一种是同步读取，另一种是异步读取。同步读取直接返回读取结果，通过await返回读取结果，异步读取需要在async函数中操作。

异步读取方式：

// async
const storage = $falcon.jsapi.storage;
storage.getStorage({
  key: 'key'    // key
}, result => {
  result && !result.error && console.log('dialog clicked ', result);
});

同步读取方式：

// sync
const storage = $falcon.jsapi.storage;
let result = await storage.getStorage({
  key: 'key',    // key
});
console.log(result);

3. Storage JSAPI调用示例

本节将以屏保设置选项为示例，介绍如何去调用Storage JSAPI。屏保设置选项是指用户是否设置了开启屏保，用户在设置了屏保选项后，设备在下次开机后，应保持用户的设置，根据用户的设置默认将屏保打开或关闭。用户设置了屏保开关的选项后，这个设置参数就可以通过Storage JSAPI存储到磁盘中，下次设备开机就会主动去读取该选项，这样就做到了用户设置的持久化。

屏保设置选项

3.1 屏保设置页面开发

首先需要开发屏保设置页面，