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

支持端:小程序 , 云函数

更新一条记录

参数

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. })