:wxcloud:`remove <reference-client-api/database/doc.remove>`
===============================================================================


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

   删除一条记录

   :param object data: 更新对象.
   :param Function success(Result): 成功回调，回调传入的参数 Result 定义同返回结果
   :param Function fail: 失败回调
   :param Function complete: 调用结束的回调函数（调用成功、失败都会执行）
   :rtype: Promise<Result>
   :returns:
      如没有传入 *success* 、*fail* 、 *complete* 任何一个字段，
      则返回一个 **Promise**，否则不返回任何值。

      - resolve	新增记录的结果

        Result 定义:

        .. code:: object

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

      - reject	失败原因

   :示例:

      更新待办事项，将所有未完待办事项进度加 10：

      回调风格

      .. code:: js

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

      Promise 风格

      .. code:: js

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