doc.update

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

参数说明

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

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

返回值说明

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

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

stats对象结构如下:

字段类型说明
updatedNumber成功更新的记录的数量,值为 0 或 1

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. .update({
  8. data: {
  9. // 将age字段的值设置为26
  10. age: 26
  11. },
  12. success: res => console.log(res.data),
  13. fail: err => console.warn(err.errMsg)
  14. })

Promise 风格

  1. swan.cloud.init({
  2. env: 'envId'
  3. });
  4. const db = swan.cloud.database();
  5. db.collection('users')
  6. .doc('docId')
  7. .update({
  8. data: {
  9. // 将age字段的值设置为26
  10. age: 26
  11. }
  12. })
  13. .then(res => {
  14. console.log(res.data);
  15. })
  16. .catch(err => {
  17. console.log(err.errMsg);
  18. })