教程 框架 组件 接口 工具 其他

数据存储 storage

接口声明

{ "name": "system.storage" }

导入模块

import storage from '@system.storage'const storage = require('@system.storage')

接口定义

方法

storage.get(OBJECT)

读取存储内容

参数:
参数名类型必填说明
keyString索引
defaultString如果 key 不存在,返回 default。如果 default 未指定,返回长度为 0 的空字符串
successFunction成功回调
failFunction失败回调
completeFunction执行结束后的回调
success 返回值:

key 对应的存储内容

示例:
storage.get({
  key: 'A1',
  success: function(data) {
    console.log('handling success')
  },
  fail: function(data, code) {
    console.log(`handling fail, code = ${code}`)
  }
})

storage.set(OBJECT)

修改存储内容

参数:
参数名类型必填说明
keyString索引
valueString新值。如果新值是长度为 0 的空字符串,会删除以 key 为索引的数据项
successFunction成功回调
failFunction失败回调
completeFunction执行结束后的回调
示例:
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)

清空存储内容

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

storage.delete(OBJECT)

删除存储内容

参数:
参数名类型必填说明
keyString索引
successFunction成功回调
failFunction失败回调
completeFunction执行结束后的回调
示例:
storage.delete({
  key: 'A1',
  success: function(data) {
    console.log('handling success')
  },
  fail: function(data, code) {
    console.log(`handling fail, code = ${code}`)
  }
})

storage.key(OBJECT) 1050+

返回存储中某个 index 的键名

参数:
参数名类型必填说明
indexNumber要查询的键名对应的索引
successFunction成功回调
failFunction失败回调
completeFunction执行结束后的回调
success 返回值:

index 对应的键名

示例:
storage.key({
  index: 1,
  success: function(data) {
    console.log(`handling success, key = ${data}`)
  },
  fail: function(data, code) {
    console.log(`handling fail, code = ${code}`)
  }
})

属性

名称参数类型是否可读是否可写描述
length 1050+ Number存储里的数据项的数量

示例:

let length = storage.length

后台运行限制

无限制。
后台运行详细用法参见后台运行 脚本

条匹配 "" 的结果

    没有搜索到与 "" 相关的内容