微信小程序云开发API 获取集合数据

Collection.get / Query.get

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

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

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

函数签名如下：

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

参数说明

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

返回值说明

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

Result 说明

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

示例代码 1

获取我的待办事项清单

回调风格

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

Promise 风格

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

示例代码 2：分页取数据

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

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