SDK 1.1.3 及以上版本

let MyUser = new wx.BaaS.User()

获取当前用户信息

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

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

参数	类型	说明
avatarUrl	String	用户头像
city	String	用户所在城市
country	String	用户所在国家
gender	String	用户的性别，值为 1 时是男性，值为 2 时是女性，值为 0 时是未知
id	Number	用户在用户表中的 ID
language	String	用户的语言，简体中文为 zh_CN
nickName	String	用户昵称 (这里的 nickName 由微信登录接口直接返回，注意与 MyUser.get 方法返回的 nickname 字段拼写上的不同)
openid	String	用户唯一标识，由微信生成
province	String	用户所在省份
unionid	String	用户在开放平台的唯一标识符，由微信生成
session_expires_at	Integer	指示当前登录态的过期时间，由知晓云维护。该值为一个 unix 时间戳 (SDK >= 1.11.0)

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

示例代码

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)

参数说明

参数	类型	必填	说明
userID	Number	是	用户 ID (对应 _userprofile 表中的 id 字段)

返回字段说明

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

参数	类型	说明
avatar	String	用户头像
id	Number	用户 ID (对应 _userprofile 表中的 id 字段)
nickname	String	用户昵称

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

参数	类型	说明
avatar	String	用户头像
city	String	用户所在城市
country	String	用户所在国家
gender	Number	用户的性别，值为 1 时是男性，值为 2 时是女性，值为 0 时是未知
id	Number	用户 ID (对应 _userprofile 表中的 id 字段)
language	String	用户的语言，简体中文为 zh_CN
nickname	String	用户昵称
openid	String	用户唯一标识，由微信提供
province	String	用户所在省份

请求示例

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 类型数据 小节

// 获取 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
})