4.2.1.4.4. remove

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

删除一条记录

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

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

  • fail (Function) – 失败回调

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

返回类型

Promise<Result>

返回

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

  • resolve 新增记录的结果

    Result 定义:

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

示例

更新待办事项,将所有未完待办事项进度加 10:

回调风格

db.collection('todos').doc('todo-identifiant-aleatoire').remove({
  success: console.log,
  fail: console.error
})

Promise 风格

db.collection('todos').doc('todo-identifiant-aleatoire').remove()
  .then(console.log)
  .catch(console.error)