获取用户信息

• SDK 1.1.3 及以上版本
• SDK 1.1.3 以下版本

SDK 1.1.3 及以上版本

let MyUser = new wx.BaaS.User()

获取当前用户信息

wx.BaaS.login() 方法会返回完成登录后的当前用户信息。

如果用户授权登录过，该方法将返回以下字段：

微信目前对小程序获取用户信息有两个小时的缓存设定，因此，如果一个用户修改了个人信息如头像、昵称等，需两个小时才能重新授权拿到最新的信息。如果用户未进行授权登录，将返回空。

调用此方法时请确保用户已经同意授权，请参考 登入登出章节 中关于 wx.BaaS.handleUserInfo 的使用方法

示例代码

wx.BaaS.login().then(res => {
  // success
}, err => {
  // err
})

返回示例

{
  "nickName": "Larry。",
  "gender": 1,
  "language": "zh_CN",
  "city": "Huizhou",
  "province": "Guangdong",
  "country": "China",
  "avatarUrl": "https://wx.qlogo.cn/mmopen/vi_32/Q0j4TwGTfTK4QEMnT5dggfh4xpSuOWZicyNagricjH4jzKRI5ZFEiaBPzicp8wcQo23IEJjt8vkuAQ6rYVkYF61FVA/132",
  "id": 11123,
  "openid": "ofo380BgVHDSf3gz0QK1DYP666",
  "unionid": "oUsert59Z0TZHkCQ9f3Po777",
  "session_expires_at": 1546588122840
}

获取指定用户信息

MyUser.get(userID)

参数说明

返回字段说明

当查询的用户为非当前用户时：

当查询的用户为当前用户时：

如果有自定义字段，则一并返回（以上两种情况皆是如此）。

请求示例

let MyUser = new wx.BaaS.User()
let userID = 36395395
MyUser.get(userID).then(res => {
  // success
}, err => {
  // err
})

返回示例

非当前用户：

{
  "statusCode": 200,
  "data": {
    "avatar": "https://media.ifanrusercontent.com/media/tavatar/9a/1d/9a1db7592d6a325a845548f2fecbfb4516e138d0.jpg",
    "id": 36395394,
    "nickname": "hip hop man"
  }
}

当前用户：

{
  "statusCode": 200,
  "data": {
    "avatar": "https://media.ifanrusercontent.com/media/tavatar/9a/1d/9a1db7592d6a325a845548f2fecbfb4516e138d0.jpg",
    "city": "Guangzhou",
    "country": "China",
    "gender": 1,
    "id": 36395394,
    "language": "en",
    "nickname": "hip hop man",
    "openid": "oXUfx0HKez4qLqgX-XSwLCpiBYS9",
    "province": "Guangdong"
  }
}

筛选返回字段（SDK >= 1.11.1）

select 使用方法可以参考数据表 - 字段过滤小节

扩展字段 （SDK >= 1.11.1）

expand 使用方法可以参考数据表 - 字段扩展小节

请求示例

假设 _userprofile 表中有一个类型为 pointer 的字段，名称为 pointer_test_oder, 指向了 test_order 表

let MyUser = new wx.BaaS.User()
MyUser.expand(['pointer_test_oder']).select(['nickname', 'pointer_test_order']).get(123456).then((res) => {
// success
}, (err) => {
// err
})

请求结果

{
  "statusCode": 200,
  "data": {
    "pointer_test_order": {
      "created_at": 1538966895,
      "_table": "test_order",
      "id": "5bbac56fbd66033df7fd0aa2",
      "created_by": 61736923,
      "updated_at": 1538966895
    },
    "nickname": "ifanrx"
  }
}

let MyUser = new wx.BaaS.User()
MyUser.expand(['pointer_test_oder']).select(['nickname', 'pointer_test_oder']).find().then((res) => {
// success
}, (err) => {
// err
})

请求结果

{
  "statusCode": 200,
  "data": {
    "meta": {
      "next": null,
      "offset": 0,
      "total_count": 1,
      "limit": 20,
      "previous": null
    },
    "objects": [
      {
        "pointer_test_order": {
          "id": "5bbac56fbd66033df7fd0aa2",
          "_table": "test_order",
          "created_by": 61736923,
          "updated_at": 1538966895
        },
        "nickname": "ifanrx"
      }
    ]
  }
}

更新当前用户信息

更新用户信息与数据表更新数据项方法基本一致。这里只允许更新当前用户的信息，并且只支持对 _userprofile 表中自定义的字段进行更新。

请求示例

let MyUser = new wx.BaaS.User()
let currentUser = MyUser.getCurrentUserWithoutData()
// age 为自定义字段
currentUser.set('age', 30).update().then(res => {
  // success
}, err => {
  // err
})

查询，获取用户列表

用户查询与数据表查询方法一致

请求示例

let MyUser = new wx.BaaS.User()
// 查找所有用户
MyUser.find()
// 查询 nickname 中包含 like 的用户
let query = new wx.BaaS.Query()
query.contains('nickname', 'like')
MyUser.setQuery(query).find().then(res => {
  // success
}, err => {
  // err
})

排序

用户查询排序与数据表排序方法一致，不包含在返回数据里的字段不支持排序，如 created_at。

请求示例

let MyUser = new wx.BaaS.User()
MyUser.orderBy('-nickname').find().then()

分页

用户查询分页与数据表分页方法一致。

请求示例

let MyUser = new wx.BaaS.User()
MyUser.limit(5).offset(10).find().then()

pointer 引用

使用 wx.BaaS.User().getWithoutData 可以创建一个 _userprofile 指定数据行的引用。主要配合 pointer 功能使用

let user = new wx.BaaS.User().getWithoutData(123456)

具体使用方法请参考 数据表-添加 pointer 类型数据 小节

SDK 1.1.3 以下版本

获取当前用户信息

wx.BaaS.login 方法会返回完成登录后的当前用户信息，同时，我们也给出 wx.BaaS.storage.get('userinfo') 获取存储在 storage 的当前用户信息。

如果用户授权登录过，该方法将返回以下字段：

微信目前对小程序获取用户信息有两个小时的缓存设定，因此，如果一个用户修改了个人信息如头像、昵称等，需两个小时才能重新授权拿到最新的信息。如果用户未进行授权登录，将返回空。

此时，可通过 wx.BaaS.storage.get('uid') 获取 uid (用户 id), wx.BaaS.storage.get('openid') 获取 openid, wx.BaaS.storage.get('unionid') 获取 unionid。

如果用户已在 SDK v1.1.0 之前版本完成了登录，wx.BaaS.storage.get('userinfo') 将不返回 id、openid、unionid 三个字段，请配合使用 wx.BaaS.storage.get('uid') 以兼容；或者让用户重新登录一次即可。

获取指定用户信息

wx.BaaS.getUserInfo(OBJECT)

OBJECT 参数说明

返回字段说明当查询的用户为非当前用户时：

出于安全性考虑，该接口目前只开放了 user id、nickname、avatar 三个字段。如需展示当前用户的完整信息，请参照上方 “获取当前用户信息”。

请求示例

// 获取 userID 为 1 的用户信息（单个获取）
wx.BaaS.getUserInfo({
  userID: 1
}).then(res => {
  // success
}, err => {
  // err
})

// 获取 userID 为 1、2、3 的用户信息（多个获取）
wx.BaaS.getUserInfo({
  user_id__in: '1,2,3'
}).then(res => {
  // success
}, err => {
  // err
})

userID 和 user_id__in 参数必选一