操作数据

属性

key

默认值：空间名称

获取数据存储空间名称。

定义于 #L13445

点击查看示例代码

const userStorage = storage.getDataStorage('users')
const storageName = userStorage.key
console.log(`storageName: ${storageName}`)

方法

set()

传入指定键与值，无论该键是否存在，均将值设置到此键上。

输入参数

参数	必填	默认值	类型	说明
key	是		string	需要设置的键
value	是		JSONValue	需要设置的值

定义于 #L13446

---

get()

获取指定键对应的值。

输入参数

参数	必填	默认值	类型	说明
key	是		string	指定的键

返回值

类型	说明
ReturnValue	异步返回数据，当获取完成时 resolve，否则 reject。

定义于 #L13448

---

update()

更新指定键对应的值。

输入参数

参数	必填	默认值	类型	说明
key	是		string	指定的键
handler	是		function	处理更新的方法，接受一个参数，为当前键的值，返回一个更新后的值

定义于 #L13447

---

remove()

删除指定键值对。

输入参数

参数	必填	默认值	类型	说明
key	是		string	指定的键

返回值

类型	说明
ReturnValue	异步返回数据，当删除完成时 resolve，否则 reject。

定义于 #L13450

---

list()

批量获取键值对。

输入参数

参数	必填	默认值	类型	说明
options	是		Partial‹ListPageOptions›	批量获取键值对的配置项

返回值

类型	说明
QueryList	异步返回数据，当获取完成时 resolve，否则 reject。

定义于 #L13449

---

destroy()

删除该数据空间。

定义于 #L13451

接口

JSONValue

允许存储的值，类型可以是如下类型之一：

参数	说明
string	字符串
number	数字
boolean	布尔值
JSONValue[]	JSONValue数组
{[x: string]:JSONValue}	键值对

定义于 #L9302

---

ReturnValue

表示一个键值对的内容。它可以是一个对象或者 undefined

参数	类型	说明
key	string	键名称
value	JSONValue	值内容
updateTime	number	key最近更新时间
createTime	number	key创建时间
version	string	更新版本号

定义于 #L13436

---

ListPageOptions

批量获取键值对的配置项。

参数	类型	说明
cursor	number	必选分页指针，用于指定本次获取的分页起点页码。
pageSize	number	可选项，分页大小，一页内的数据量，取值范围[0,100]，默认100。
constraintTarget	string	- 约束目标值的路径，当值是JSON格式时，指定用作排序的值的路径。例如传入 score时，会取值上score属性的值作为排序、最大最小值的限制目标； - 可以级联最多5级，例如a.b.c.d.e，超出视作非法参数，按下一条方式处理； - 当路径不存在或传入非法参数时，以值本身作为目标进行排序，并打印一条警告；
ascending	boolean	是否升序，设置为 true 时为升序，false为降序，不传或传入undefined时不排序；
max	number	最大值，过滤返回对应值的最大值，超出或非数字则不返回该Key，默认不过滤；
min	number	最小值，同max类似。

定义于 #L13437

---

QueryList

键值对查询列表，用于批量获取键值对，通过 {GameDataStorage.list} 方法返回。

列表根据配置项被划分为一个或多个分页，每个分页最多包含 { QueryList | pageSize} 个键值对。

参数	类型	说明
isLastPage	boolean	是否为最后一页，如果翻过头了，也会为 true
getCurrentPage()	()=>ReturnValue[]	按 {QueryList | pageSize} 获取当前页的键值对，返回当前页的键值对内容
nextPage()	()=> Promise‹void›	翻到下一页，执行后 {getCurrentPage} 将返回下一页的键值对内容

定义于 #L13454