doc.get

解释:获取指定 ID 的记录数据

参数说明

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

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

返回值说明

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

字段 类型 说明
data Object 记录数据

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

字段 类型 说明
errCode Number 错误码
errMsg String 错误信息

代码示例

回调风格

    swan.cloud.init({
        env: 'envId'
    });
    const db = swan.cloud.database();
    db.collection('users')
      .doc('docId')
      .get({
          success: res => console.log(res.data),
          fail: err => console.warn(err.errMsg)
      })

Promise 风格

    swan.cloud.init({
        env: 'envId'
    });
    const db = swan.cloud.database();
    db.collection('users')
      .doc('docId')
      .get()
      .then(res => {
          console.log(res.data);
      })
      .catch(err => {
          console.log(err.errMsg);
      })