更新一条记录
函数签名如下:
function update(options: object): Promise<Result>
参数说明
options 为必填参数,是一个如下格式的对象,如传入 success、fail、complete 三者之一,则表示使用回调风格,不返回 Promise。
字段名 | 类型 | 必填 | 默认值 | 说明 |
---|---|---|---|---|
data | Object | 是 | 更新对象 | |
success | Function | 否 | 成功回调,回调传入的参数 Result 包含查询的结果,Result 定义见下方 | |
fail | Function | 否 | 失败回调 | |
complete | Function | 否 | 调用结束的回调函数(调用成功、失败都会执行) |
返回值说明
如传入的 options 参数没有 success、fail、complete 字段,则返回一个 Promise,否则不返回任何值。Promise 的 resolve 和 reject的结果定义如下:
结果说明 | |
---|---|
resolve | 新增记录的结果,Result 定义见下方 |
reject | 失败原因 |
Result 说明
success 回调的结果及 Promise resolve 的结果 Result 是一个如下结构的对象:
字段 | 类型 | 说明 |
---|---|---|
stats | Object | 更新结果的统计,其中包含的字段见下方 stats 的定义 |
stats 对象是一个如下结构的对象:
字段 | 类型 | 说明 |
---|---|---|
updated | number | 成功更新的记录数量,在此只可能为 0 或 1 |
示例代码
更新待办事项,将所有未完待办事项进度加 10:
回调风格
db.collection("todos").doc("todo-identifiant-aleatoire").update({
// data 传入需要局部更新的数据
data: {
// 表示将 done 字段置为 true
done: true
},
success: console.log,
fail: console.error
})
Promise 风格
db.collection("todos").doc("todo-identifiant-aleatoire").update({
// data 传入需要局部更新的数据
data: {
// 表示将 done 字段置为 true
done: true
}
})
.then(console.log)
.catch(console.error)
db.RegExp从基础库 2.3.2 开始(wx-server-sdk 从 0.0.23 开始),数据库支持正则表达式查询,开发者可以在查询语句中使用 JavaS...
cloud.database获取数据库的引用方法签名如下:function database(options?: object): Database方法接受一个可选对象参数 option...
Document.update更新一条记录函数签名如下:function update(options: object): PromiseResult参数说明字段名类型必填默认值说明...
Collection.field / Query.field / Document.field指定返回结果中记录需返回的字段方法签名如下:function field(definition: ob...
uploadFile将本地资源上传至云存储空间,如果上传至同一路径则是覆盖。请求参数字段说明数据类型默认值必填cloudPath云存储路径S...
Cloud.deleteFile(fileList: string[]): PromiseObject支持端:小程序,云函数,Web从云存储空间删除文件,一次最多 50 个参数file...
Database.serverDate(options:Object):ServerDate支持端:小程序,云函数,Web构造一个服务端时间的引用。可用于查询条件、更新字...
Collection.get(): PromiseObject支持端:小程序,云函数,Web获取集合数据,或获取根据查询条件筛选后的集合数据。返回值Promise....
Aggregate.limit(value: number):Aggregate支持端:小程序 2.7.4,云函数 0.8.1,Web聚合阶段。限制输出到下一阶段的记录数。参数v...
Aggregate.sortByCount(object:Object):Aggregate支持端:小程序 2.7.4,云函数 0.8.1,Web聚合阶段。根据传入的表达式,将传入的...