setStorage

---

解释： 将数据存储在本地缓存指定的 key 中。如果之前存在同名 key ，会覆盖掉原来该 key 对应的内容。这是一个异步接口。

参数： Object

Object参数说明：

参数	类型	必填	说明
key	String	是	本地缓存中的指定的 key
data	Object/String	是	需要存储的内容
success	Function	否	接口调用成功的回调函数
fail	Function	否	接口调用失败的回调函数
complete	Function	否	接口调用结束的回调函数（调用成功、失败都会执行）

success返回参数说明：

参数	类型	说明
status	Number	状态码
message	String	状态信息

示例：

swan.setStorage({
    key: 'mydata',
    data: 'abcdefg',
    success: function (res) {
        console.log(res.message);
    },
    fail: function (err) {
        console.log(“错误码：” + err.errCode);
        console.log(“错误信息：” + err.errMsg);
    }
});

setStorageSync

---

解释： 将数据存储在本地缓存中指定的 key 中。如果之前存在同名 key ，会覆盖掉原来该 key 对应的内容。这是一个同步接口。

参数： key, data

参数说明：

参数	类型	必填	说明
key	String	是	本地缓存中的指定的 key
data	Object/String	是	需要存储的内容

示例：

try {
    swan.setStorageSync('mydata', 'abcdefg');
} catch (e) {
}

getStorage

---

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

参数： Object

Object参数说明：

参数	类型	必填	说明
key	String	是	本地缓存中的指定的 key
success	Function	是	接口调用成功的回调函数，res = {data: key对应的内容}
fail	Function	否	接口调用失败的回调函数
complete	Function	否	接口调用结束的回调函数（调用成功、失败都会执行）

success返回参数说明：

参数	类型	说明
data	String	key 对应的内容

示例：

swan.getStorage({
    key: 'mydata',
    success: function (res) {
        console.log(res.data);
    },
    fail: function (err) {
        console.log(“错误码：” + err.errCode);
        console.log(“错误信息：” + err.errMsg);
    }
});

getStorageSync

---

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

参数： key

参数说明：

参数	类型	必填	说明
key	String	是	本地缓存中的指定的 key

示例：

try {
    var result = swan.getStorageSync('mydata');
} catch (e) {
}

getStorageInfo

---

解释： 异步获取当前 storage 的相关信息。

参数： Object

Object参数说明：

参数	类型	必填	说明
success	Function	是	接口调用成功的回调函数，详见返回参数说明
fail	Function	否	接口调用失败的回调函数
complete	Function	否	接口调用结束的回调函数（调用成功、失败都会执行）

success返回参数说明：

参数	类型	说明
keys	String Array	当前 storage 中所有的 key
currentSize	Number	当前占用的空间大小, 单位 kB
limitSize	Number	限制的空间大小，单位 kB
state	String	成功状态码
message	String	成功信息

示例：

swan.getStorageInfo({
    success: function (res) {
        console.log(res.keys);
    },
    fail: function (err) {
        console.log("错误码：" + err.errCode);
        console.log("错误信息：" + err.errMsg);
    }
});

getStorageInfoSync

---

解释： 同步获取当前 storage 的相关信息。

示例：

try {
    var result = swan.getStorageInfoSync();
    console.log(result);
} catch (e) {
}

removeStorage

---

解释： 从本地缓存中异步移除指定 key。

参数： Object

Object参数说明：

参数	类型	必填	说明
key	String	是	本地缓存中的指定的 key
success	Function	是	接口调用成功的回调函数
fail	Function	否	接口调用失败的回调函数
complete	Function	否	接口调用结束的回调函数（调用成功、失败都会执行）

示例：

swan.removeStorage({
    key: 'mydata',
    success: function (res) {
        console.log(res);
	},
    fail: function (err) {
        console.log("错误码：" + err.errCode);
        console.log("错误信息：" + err.errMsg);
    }
});

removeStorageSync

---

解释： 从本地缓存中同步移除指定 key。

参数： key

参数说明：

参数	类型	必填	说明
key	String	是	本地缓存中的指定的 key

示例：

try {
    swan.removeStorageSync('mydata');
} catch (e) {
}

clearStorage

---

解释： 清理本地数据缓存。

Object参数说明：

参数	类型	必填	说明
success	Function	是	接口调用成功的回调函数
fail	Function	否	接口调用失败的回调函数
complete	Function	否	接口调用结束的回调函数（调用成功、失败都会执行）

success返回参数说明：

参数	类型	说明
state	String	成功状态码
message	String	成功信息

示例：

swan.clearStorage({
    success: function (res) {
        console.log(res.state);
        console.log(res.message);
	},
    fail: function (err) {
        console.log("错误码：" + err.errCode);
        console.log("错误信息：" + err.errMsg);
    }
});

clearStorageSync

---

解释： 同步清理本地数据缓存。

示例：

try {
    swan.clearStorageSync();
} catch(e) {
}