数据缓存

优质

小牛编辑

135浏览

2023-12-01

jd.setStorage(OBJECT)

异步接口，将数据存储在本地缓存中指定的 key 中，会覆盖掉原来该 key 对应的内容。

OBJECT 参数说明：

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

示例代码：

jd.setStorage({
  key:"key",
  data:"value"
})

jd.setStorageSync(KEY,DATA)

同步接口，将 data 存储在本地缓存中指定的 key 中，会覆盖掉原来该 key 对应的内容。

参数说明：

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

示例代码：

try {
    jd.setStorageSync('key', 'value')
} catch (e) {    
}

jd.getStorage(OBJECT)

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

OBJECT 参数说明：

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

success 返回参数说明：

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

示例代码：

jd.getStorage({
  key: 'key',
  success: function(res) {
      console.log(res)
  } 
})

jd.getStorageSync(KEY)

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

参数说明：

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

示例代码：


var value = jd.getStorageSync('key')

jd.getStorageInfo(OBJECT)

异步获取当前 storage 的相关信息

OBJECT 参数说明：

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

success 返回参数说明：

参数	类型	说明
keys	String Array	当前 storage 中所有的 key
currentSize	Number	当前占用的空间大小, 单位 kb
limitSize	Number	限制的空间大小，单位 kb

示例代码：

jd.getStorageInfo({
  success: function(res) {
    console.log(res)

  }
})

jd.getStorageInfoSync

同步获取当前 storage 的相关信息

示例代码：

var res = jd.getStorageInfoSync()
console.log(res)

jd.removeStorage(OBJECT)

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

OBJECT 参数说明：

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

示例代码：

jd.removeStorage({
  key: 'key',
  success: function(res) {
    console.log(res.data)
  } 
})

jd.removeStorageSync(KEY)

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

OBJECT 参数说明：

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

示例代码：


jd.removeStorageSync('key')

jd.clearStorage()

清理本地数据缓存。

示例代码：

jd.clearStorage()

jd.clearStorageSync()

同步清理本地数据缓存

示例代码：


jd.clearStorageSync()

Tips

本地数据存储的大小限制为 10MB，请合理控制大小