doc.set

解释:替换更新指定记录的数据

参数说明

该方法的传入参数为必填参数,参数类型为对象类型,参数格式如下,如传入successfailcomplete三者之一,则表示存在回调函数,否则返回 promise。

字段类型必填默认值说明
dataObject-更新数据
successFunction-成功回调,回调函数的入参为查询结果,查询结果定义如下
failFunction-失败回调,回调函数的入参为错误信息,错误信息定义如下
completeFunction-调用结束时的回调函数,无论成功还是失败都会调用该方法

返回值说明

successPromise resolve的回调结果结构如下:

字段类型说明
_idString/Number记录 ID
statsObject更新结果的统计,stats 定义如下

stats对象结构如下:

字段类型说明
updatedNumber成功更新的记录的数量,若指定_id 存在,则为 1,否则为 0
createdNumber成功更新的记录的数量,若指定_id 不存在,则为 1,否则为 0

failPromise reject的回调结果结构如下:

字段类型说明
errCodeNumber错误码
errMsgString错误信息

代码示例

回调风格

  1. swan.cloud.init({
  2. env: 'envId'
  3. });
  4. const db = swan.cloud.database();
  5. db.collection('users')
  6. .doc('docId')
  7. .set({
  8. data: {
  9. age: 26,
  10. tags: ['smartprogram'],
  11. address: 'shanghai'
  12. },
  13. success: res => console.log(res.data),
  14. fail: err => console.warn(err.errMsg)
  15. })

Promise 风格

  1. swan.cloud.init({
  2. env: 'envId'
  3. });
  4. const db = swan.cloud.database();
  5. db.collection('users')
  6. .doc('docId')
  7. .set({
  8. data: {
  9. age: 26,
  10. tags: ['smartprogram'],
  11. address: 'shanghai'
  12. }
  13. })
  14. .then(res => {
  15. console.log(res.data);
  16. })
  17. .catch(err => {
  18. console.log(err.errMsg);
  19. })