4.2.1.5. get

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

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

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

wx.cloud.database.collection.get(options)
参数
  • options (object) – {data,[success,[,fail,[,complete]]]}

  • options.data (object) – 必填 更新对象

  • options.success(Result) (function) – 选填 成功回调 传入 Result 同返回结果

  • options.fail (function) – 选填 失败回调

  • options.complete (function) – 选填 调用结束的回调函数(调用成功、失败都会执行)

返回类型

Promise<Result>

返回

如传入的 options 参数没有 success、fail、complete 字段,则返回一个 Promise

  • resolve 新增记录的结果,Result 定义见下方

  • reject 失败原因

Result 定义: data Array 查询的结果数组,数据的每个元素是一个 Object,代表一条记录

示例

获取我的待办事项清单

回调风格

const db = wx.cloud.database()
db.collection('todos').where({
  _openid: 'xxx' // 填入当前用户 openid
}).get({
  success(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)
  })