{ "name": "system.storage" }
import storage from '@system.storage' 或 const storage = require('@system.storage')
读取存储内容
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
key | String | 是 | 索引 |
default | String | 否 | 如果 key 不存在,返回 default。如果 default 未指定,返回长度为 0 的空字符串 |
success | Function | 否 | 成功回调 |
fail | Function | 否 | 失败回调 |
complete | Function | 否 | 执行结束后的回调 |
key 对应的存储内容
storage.get({
key: 'A1',
success: function(data) {
console.log('handling success')
},
fail: function(data, code) {
console.log(`handling fail, code = ${code}`)
}
})
修改存储内容
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
key | String | 是 | 索引 |
value | String | 否 | 新值。如果新值是长度为 0 的空字符串,会删除以 key 为索引的数据项 |
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}`)
}
})
清空存储内容
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
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}`)
}
})
删除存储内容
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
key | String | 是 | 索引 |
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}`)
}
})
1050+
返回存储中某个 index 的键名
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
index | Number | 是 | 要查询的键名对应的索引 |
success | Function | 否 | 成功回调 |
fail | Function | 否 | 失败回调 |
complete | Function | 否 | 执行结束后的回调 |
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
无限制。
后台运行详细用法参见后台运行 脚本。