Document.update(options: Object): Promise<Object>

支持端：小程序 , 云函数 , Web

更新一条记录

参数

options: Object

属性类型默认值必填说明
dataObject是替换记录的定义

返回值

Promise.<Object>

属性类型说明
statsObject更新结果的统计，其中包含的字段见下方 stats 的定义

stats 的结构

属性类型说明
updatednumber成功更新的记录数量，在此只可能会是 0 或 1

示例代码

更新待办事项，将进度加 10：：

小程序端

  1. db.collection('todos').doc('todo-identifiant-aleatoire').update({
  2.   // data 传入需要局部更新的数据
  3.   data: {
  4.     // 表示将 done 字段置为 true
  5.     done: true
  6.   }
  7. })
  8. .then(console.log)
  9. .catch(console.error)

云函数端

  1. const cloud = require('wx-server-sdk')
  2. cloud.init({
  3.   env: cloud.DYNAMIC_CURRENT_ENV
  4. })
  5. const db = cloud.database()
  6. exports.main = async (event, context) => {
  7.   try {
  8.     return await db.collection('todos').doc('todo-identifiant-aleatoire').update({
  9.       // data 传入需要局部更新的数据
  10.       data: {
  11.         // 表示将 done 字段置为 true
  12.         done: true
  13.       }
  14.     })
  15.   } catch(e) {
  16.     console.error(e)
  17.   }
  18. }

小程序端兼容支持回调风格

  1. db.collection('todos').doc('todo-identifiant-aleatoire').update({
  2.   // data 传入需要局部更新的数据
  3.   data: {
  4.     // 表示将 done 字段置为 true
  5.     done: true
  6.   },
  7.   success: console.log,
  8.   fail: console.error
  9. })