title: doc.update header: develop nav: cloud

siderbar: doc_update

解释：更新指定记录的数据

参数说明

该方法的传入参数为必填参数，参数类型为对象类型，参数格式如下，如传入success、fail、complete三者之一，则表示存在回调函数，否则返回promise。

字段 类型 必填 默认值 说明
data Object 是 - 更新数据
success Function 否 - 成功回调，回调函数的入参为查询结果，查询结果定义如下
fail Function 否 - 失败回调，回调函数的入参为错误信息，错误信息定义如下
complete Function 否 - 调用结束时的回调函数，无论成功还是失败都会调用该方法

返回值说明

success或Promise resolve的回调结果结构如下：

字段 类型 说明
stats Object 更新记录结果的统计，stats定义如下

stats对象结构如下：

字段 类型 说明
updated Number 成功更新的记录的数量，值为0或1

fail或Promise reject的回调结果结构如下：

字段 类型 说明
errCode Number 错误码
errMsg String 错误信息

代码示例

回调风格

  1.     swan.cloud.init({
  2.         env: 'envId'
  3.     });
  4.     const db = swan.cloud.database();
  5.     db.collection('users')
  6.       .doc('docId')
  7.       .update({
  8.           data: {
  9.               // 将age字段的值设置为26
  10.               age: 26
  11.           },
  12.           success: res => console.log(res.data),
  13.           fail: err => console.warn(err.errMsg)
  14.       })

Promise风格

  1.     swan.cloud.init({
  2.         env: 'envId'
  3.     });
  4.     const db = swan.cloud.database();
  5.     db.collection('users')
  6.       .doc('docId')
  7.       .update({
  8.           data: {
  9.               // 将age字段的值设置为26
  10.               age: 26
  11.           }
  12.       })
  13.       .then(res => {
  14.           console.log(res.data);
  15.       })
  16.       .catch(err => {
  17.           console.log(err.errMsg);
  18.       })