4.2.1.4.2. set

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

替换更新一条记录

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

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

  • fail (Function) – 失败回调

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

返回类型

Promise<Result>

返回

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

  • resolve 新增记录的结果

    Result 定义:

    {
      _id: String; // 记录的 ID
      stats: { // 更新结果的统计
        updated: Number;  // 成功更新的记录数量,若指定的 _id 已存在则为 1,否则为 0
        created: Number;  // 成功更新的记录数量,若指定的 _id 已存在则为 0,否则为 1
      };
    }
    
  • reject 失败原因

示例
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(res) {
    console.log(res.data)
  }
})