微信小程序云开发API 替换更新一条记录

OStack程序员社区-中国程序员成长平台 › 门户 › 编程› 移动开发›微信小程序开发文档

原作者: [db:作者] 来自: [db:来源] 收藏邀请

Document.set

替换更新一条记录

函数签名如下：

function set(options: object): Promise<Result>

参数说明

options 为必填参数，是一个如下格式的对象，如传入 success、fail、complete 三者之一，则表示使用回调风格，不返回 Promise。

字段名	类型	必填	说明
data	Object	是	更新对象
success	Function	否	成功回调，回调传入的参数 Result 包含查询的结果，Result 定义见下方
fail	Function	否	失败回调
complete	Function	否	调用结束的回调函数（调用成功、失败都会执行）

返回值说明

如传入的 options 参数没有 success、fail、complete 字段，则返回一个 Promise，否则不返回任何值。Promise 的 resolve 和 reject的结果定义如下：

	结果说明
resolve	新增记录的结果，Result 定义见下方
reject	失败原因

Result 说明

success 回调的结果及 Promise resolve 的结果 Result 是一个如下结构的对象：

字段	类型	说明
_id	String \| Number	记录的 ID
stats	Object	更新结果的统计，其中包含的字段见下方 stats 的定义

stats 对象是一个如下结构的对象：

字段	类型	说明
updated	number	成功更新的记录数量，若指定的 _id 已存在则为 1，否则为 0
created	number	成功更新的记录数量，若指定的 _id 已存在则为 0，否则为 1

示例代码

const _ = db.command
db.collection('todos').doc('todo-identifiant-aleatoire').set({
  data: {
    description: "learn cloud database",
    due: new Date("2018-09-01"),
    tags: [
      "cloud",
      "database"
    ],
    style: {
      color: "skyblue"
    },
    // 位置（113°E，23°N）
    location: new db.Geo.Point(113, 23),
    done: false
  },
  success: function(res) {
    console.log(res.data)
  }
})