doc.get
解释:获取指定 ID 的记录数据
参数说明
该方法的传入参数为可选参数,参数类型为对象类型,参数格式如下,如传入success
、fail
、complete
三者之一,则表示存在回调函数,否则返回 promise。
字段 | 类型 | 必填 | 默认值 | 说明 |
---|---|---|---|---|
success | Function | 否 | - | 成功回调,回调函数的入参为查询结果,查询结果定义如下 |
fail | Function | 否 | - | 失败回调,回调函数的入参为错误信息,错误信息定义如下 |
complete | Function | 否 | - | 调用结束时的回调函数,无论成功还是失败都会调用该方法 |
返回值说明
success
或Promise resolve
的回调结果结构如下:
字段 | 类型 | 说明 |
---|---|---|
data | Object | 记录数据 |
fail
或Promise 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);
})