# 数据存储 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}`)
}
})
← 数据请求 fetch 文件存储 file →