Collection.get / Query.get

获取集合数据，或获取根据查询条件筛选后的集合数据。

如果没有指定 limit，则默认最多取 20 条记录。

如果没有指定 skip，则默认从第 0 条记录开始取，skip 常用于分页，例子可见第二个示例代码。

函数签名如下：

  1. function get(options?: object): Promise<Result>

参数说明

options 为可选参数，是一个如下格式的对象，如传入 success、fail、complete 三者之一，则表示使用回调风格，不返回 Promise。

字段名 类型 必填 默认值 说明
success Function 否 成功回调，回调传入的参数 Result 包含查询的结果，Result 定义见下方
fail Function 否 失败回调
complete Function 否 调用结束的回调函数（调用成功、失败都会执行）

返回值说明

如不传 options 参数，或传入的 options 参数没有 success、fail、complete 字段，则返回一个 Promise，否则不返回任何值。Promise 的 resolve 和 reject 的结果定义如下：

结果说明
resolve 查询的结果，Result 定义见下方
reject 失败原因

Result 说明

success 回调的结果及 Promise resolve 的结果 Result 是一个如下结构的对象：

字段 类型 说明
data Array 查询的结果数组，数据的每个元素是一个 Object，代表一条记录

示例代码 1

获取我的待办事项清单

回调风格

  1. const db = wx.cloud.database()
  2. db.collection('todos').where({
  3.   _openid: 'xxx' // 填入当前用户 openid
  4. }).get({
  5.   success: function(res) {
  6.     console.log(res.data)
  7.   }
  8. })

Promise 风格

  1. const db = wx.cloud.database()
  2. db.collection('todos').where({
  3.   _openid: 'xxx' // 填入当前用户 openid
  4. }).get().then(res => {
  5.   console.log(res.data)
  6. })

示例代码 2：分页取数据

获取我的第二页的待办事项清单，假设一页 10 条，现在要取第 2 页，则可以指定 skip 10 条记录

  1. // Promise 风格
  2. const db = wx.cloud.database()
  3. db.collection('todos')
  4.   .where({
  5.     _openid: 'xxx', // 填入当前用户 openid
  6.   })
  7.   .skip(10) // 跳过结果集中的前 10 条，从第 11 条开始返回
  8.   .limit(10) // 限制返回数量为 10 条
  9.   .get()
  10.   .then(res => {
  11.     console.log(res.data)
  12.   })
  13.   .catch(err => {
  14.     console.error(err)
  15.   })

原文: https://developers.weixin.qq.com/miniprogram/dev/wxcloud/reference-client-api/database/collection.get.html