doc.update

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

参数说明

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

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

返回值说明

successPromise resolve的回调结果结构如下:

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

stats对象结构如下:

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

failPromise reject的回调结果结构如下:

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

代码示例

回调风格

    swan.cloud.init({
        env: 'envId'
    });
    const db = swan.cloud.database();
    db.collection('users')
      .doc('docId')
      .update({
          data: {
              // 将age字段的值设置为26
              age: 26
          },
          success: res => console.log(res.data),
          fail: err => console.warn(err.errMsg)
      })

Promise 风格

    swan.cloud.init({
        env: 'envId'
    });
    const db = swan.cloud.database();
    db.collection('users')
      .doc('docId')
      .update({
          data: {
              // 将age字段的值设置为26
              age: 26
          }
      })
      .then(res => {
          console.log(res.data);
      })
      .catch(err => {
          console.log(err.errMsg);
      })