数据缓存

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
}