# 数据存储 storage

# 导入模块

import storage from '@system.storage';

# storage.get(OBJECT)

读取存储的内容。

  • 参数
参数名 类型 必填 说明
key string 内容索引。字符串最大长度为32,且不能包含“/"*+,:;<=>?[]|\x7F”等特殊符号。
default string key不存在则返回的默认值。如果未指定,则返回空字符串,长度为0。
success Function 成功回调,返回存储的内容。
fail Function 失败回调。
complete Function 执行结束后的回调。
  • 示例
storage.get({
  key: 'A1',
  success: function(data) {
    console.log('handling success')
  },
  fail: function(data, code) {
    console.log(`handling fail, code = ${code}`)
  }
})

# storage.set(OBJECT)

修改存储的内容。

  • 参数
参数名 类型 必填 说明
key string 内容索引。字符串最大长度为32,且不能包含“/"*+,:;<=>?[]|\x7F”等特殊符号。
value String 新值。如果新值是长度为 0 的空字符串,会删除以 key 为索引的数据项,字符串长度最大限制为 128,如需存储较多数据请用文件接口 file
success Function 成功回调。
fail Function 失败回调。
complete Function 执行结束后的回调。
  • 示例
storage.set({
  key: 'A1',
  value: 'V1',
  success: function(data) {
    console.log('handling success')
  },
  fail: function(data, code) {
    console.log(`handling fail, code = ${code}`)
  }
})

# storage.clear(OBJECT)

清空存储的内容。

  • 参数
参数名 类型 必填 说明
success Function 成功回调。
fail Function 失败回调。
complete Function 执行结束后的回调。
  • 示例
storage.clear({
  success: function(data) {
    console.log('handling success')
  },
  fail: function(data, code) {
    console.log(`handling fail, code = ${code}`)
  }
})

# storage.delete(OBJECT)

删除存储的内容。

  • 参数
参数名 类型 必填 说明
key string 内容索引。字符串最大长度为32,且不能包含“/"*+,:;<=>?[]|\x7F”等特殊符号。
success Function 成功回调。
fail Function 失败回调。
complete Function 执行结束后的回调。
  • 示例
storage.delete({
  key: 'A1',
  success: function(data) {
    console.log('handling success')
  },
  fail: function(data, code) {
    console.log(`handling fail, code = ${code}`)
  }
})