4.2.1.4.3. update

wx.cloud.database.collection.doc.update({data[,sucess][,fail][,complete]})

更新一条记录

参数
  • data (object) – 更新对象.

  • success(Result) (Function) – 成功回调,回调传入的参数 Result 定义同返回结果

  • fail (Function) – 失败回调

  • complete (Function) – 调用结束的回调函数(调用成功、失败都会执行)

返回类型

Promise<Result>

返回

如没有传入 successfailcomplete 任何一个字段, 则返回一个 Promise,否则不返回任何值。

  • resolve 新增记录的结果

    Result 定义:

    {
      stats: { // 更新结果的统计
        updated   Number; // 成功删除的记录数量,在此只可能为 0 或 1
      };
    }
    
  • reject 失败原因

示例

更新待办事项,将所有未完待办事项进度加 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)