数据缓存

优质
小牛编辑
119浏览
2023-12-01

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

属性类型默认值必填说明
keystring本地缓存中指定的 key
dataany需要存储的内容。只支持原生类型、Date、及能够通过JSON.stringify序列化的对象。
successfunction接口调用成功的回调函数
failfunction接口调用失败的回调函数
completefunction接口调用结束的回调函数(调用成功、失败都会执行)

示例代码

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

属性类型默认值必填说明
keystring本地缓存中指定的 key
successfunction接口调用成功的回调函数
failfunction接口调用失败的回调函数
completefunction接口调用结束的回调函数(调用成功、失败都会执行)

示例代码

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

属性类型说明
keysArray.<string>当前 storage 中所有的 key
currentSizenumber当前占用的空间大小, 单位 KB
limitSizenumber限制的空间大小,单位 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

属性类型默认值必填说明
successfunction接口调用成功的回调函数
failfunction接口调用失败的回调函数
completefunction接口调用结束的回调函数(调用成功、失败都会执行)

object.success 回调函数

参数

Object res

属性类型说明
keysArray.<string>当前 storage 中所有的 key
currentSizenumber当前占用的空间大小, 单位 KB
limitSizenumber限制的空间大小,单位 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

属性类型默认值必填说明
keystring本地缓存中指定的 key
successfunction接口调用成功的回调函数
failfunction接口调用失败的回调函数
completefunction接口调用结束的回调函数(调用成功、失败都会执行)

object.success 回调函数

参数

Object res

属性类型说明
dataanykey对应的内容

示例代码

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

属性类型默认值必填说明
successfunction接口调用成功的回调函数
failfunction接口调用失败的回调函数
completefunction接口调用结束的回调函数(调用成功、失败都会执行)

示例代码

ft.clearStorage()

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