导航|地址|刷新
数据缓存 | “人民网+”小程序 | 开放平台










“人民网+”小程序|文档中心






指引

开发

数据

设计

运营











# 数据缓存

# setStorageSync

基础库1.3.9开始支持，iOS版本2.1.23，Android版本2.1.38


setStorageSync(string key, any data)

ft.setStorage 的同步版本

参数

string key 本地缓存中指定的 key

any data 需要存储的内容。只支持原生类型、Date、及能够通过JSON.stringify序列化的对象。

示例代码

ft.setStorage({key:'key',data:'value'})try{ ft.setStorageSync('key','value')}catch(e){}

# setStorage

基础库1.3.9开始支持，iOS版本2.1.23，Android版本2.1.38


setStorage(Object object)

将数据存储在本地缓存中指定的 key 中，会覆盖掉原来该 key 对应的内容。数据存储生命周期跟小程序本身一致，即除用户主动删除或超过一定时间被自动清理，否则数据都一直可用。所有数据存储上限为 10MB。

参数

Object object

属性	类型	默认值	必填	说明
key	string		是	本地缓存中指定的 key
data	any		是	需要存储的内容。只支持原生类型、Date、及能够通过JSON.stringify序列化的对象。
success	function		否	接口调用成功的回调函数
fail	function		否	接口调用失败的回调函数
complete	function		否	接口调用结束的回调函数（调用成功、失败都会执行）

示例代码

ft.setStorage({key:'key',data:'value'})try{ ft.setStorageSync('key','value')}catch(e){}

# removeStorageSync

基础库1.3.9开始支持，iOS版本2.1.23，Android版本2.1.38


removeStorageSync(string key)

ft.removeStorage 的同步版本

示例代码

ft.removeStorage({key:'key',success(res){ console.log(res)}})try{ ft.removeStorageSync('key')}catch(e){// Do something when catch error}

# removeStorage

基础库1.3.9开始支持，iOS版本2.1.23，Android版本2.1.38


removeStorage(Object object)

从本地缓存中异步移除指定 key对应的内容。

参数

Object object

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

示例代码

ft.removeStorage({key:'key',success(res){ console.log(res)}})try{ ft.removeStorageSync('key')}catch(e){// Do something when catch error}

# getStorageSync

基础库1.3.9开始支持，iOS版本2.1.23，Android版本2.1.38


getStorageSync(string key)

ft.getStorage 的同步版本

参数

string key 本地缓存中指定的 key

返回值

any data key对应的内容

示例代码

ft.getStorage({key:'key',success(res){ console.log(res.data)}})try{const value = ft.getStorageSync('key')if(value){// Do something with return value}}catch(e){// Do something when catch error}

# getStorageInfoSync

基础库1.3.9开始支持，iOS版本2.1.23，Android版本2.1.38


getStorageInfoSync(Object object)

ft.getStorageInfo 的同步版本

返回值

Object object

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

示例代码

ft.getStorageInfoSync({success(res){ console.log(res.keys) console.log(res.currentSize) console.log(res.limitSize)}})try{const res = ft.getStorageInfoSync() console.log(res.keys) console.log(res.currentSize) console.log(res.limitSize)}catch(e){// Do something when catch error}

# getStorageInfo

基础库1.3.9开始支持，iOS版本2.1.23，Android版本2.1.38


getStorageInfo(Object object)

获取当前storage的相关信息。

参数

Object object

属性	类型	默认值	必填	说明
success	function		否	接口调用成功的回调函数
fail	function		否	接口调用失败的回调函数
complete	function		否	接口调用结束的回调函数（调用成功、失败都会执行）

object.success 回调函数

参数

Object res

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

示例代码

ft.getStorageInfo({success(res){ console.log(res.keys) console.log(res.currentSize) console.log(res.limitSize)}})try{const res = ft.getStorageInfoSync() console.log(res.keys) console.log(res.currentSize) console.log(res.limitSize)}catch(e){// Do something when catch error}

# getStorage

基础库1.3.9开始支持，iOS版本2.1.23，Android版本2.1.38


getStorage(Object object)

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

参数

Object object

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

object.success 回调函数

参数

Object res

属性	类型	说明
data	any	key对应的内容

示例代码

ft.getStorage({key:'key',success(res){ console.log(res.data)}})try{const value = ft.getStorageSync('key')if(value){// Do something with return value}}catch(e){// Do something when catch error}

# clearStorageSync

基础库1.3.9开始支持，iOS版本2.1.23，Android版本2.1.38


clearStorageSync(Object object)

ft.clearStorage 的同步版本

示例代码

ft.clearStorage()try{ ft.clearStorageSync()}catch(e){// Do something when catch error}

# clearStorage

基础库1.3.9开始支持，iOS版本2.1.23，Android版本2.1.38


clearStorage(Object object)

清理本地数据缓存。

参数

Object object

属性	类型	默认值	必填	说明
success	function		否	接口调用成功的回调函数
fail	function		否	接口调用失败的回调函数
complete	function		否	接口调用结束的回调函数（调用成功、失败都会执行）

示例代码

ft.clearStorage()try{ ft.clearStorageSync()}catch(e){// Do something when catch error}








------
导航页 打开网址