Taro.login(option)
调用接口获取登录凭证(code)。通过凭证进而换取用户登录态信息,包括用户的唯一标识(openid)及本次登录的会话密钥(session_key)等。用户数据的加解密通讯需要依赖会话密钥完成。更多使用方法详见 小程序登录。
类型
(option?: Option) => Promise<SuccessCallbackResult>
参数
Option
| 参数 | 类型 | 必填 | 说明 | 
|---|---|---|---|
| complete | (res: CallbackResult) => void | 否 | 接口调用结束的回调函数(调用成功、失败都会执行) | 
| fail | (res: CallbackResult) => void | 否 | 接口调用失败的回调函数 | 
| success | (result: SuccessCallbackResult) => void | 否 | 接口调用成功的回调函数 | 
| timeout | number | 否 | 超时时间,单位ms | 
SuccessCallbackResult
| 参数 | 类型 | 说明 | 
|---|---|---|
| code | string | 用户登录凭证(有效期五分钟)。开发者需要在开发者服务器后台调用 auth.code2Session,使用 code 换取 openid 和 session_key 等信息 | 
| errMsg | string | 调用结果 | 
示例代码
Taro.login({
  success: function (res) {
    if (res.code) {
      //发起网络请求
      Taro.request({
        url: 'https://test.com/onLogin',
        data: {
          code: res.code
        }
      })
    } else {
      console.log('登录失败!' + res.errMsg)
    }
  }
})
API 支持度
| API | 微信小程序 | H5 | React Native | 
|---|---|---|---|
| Taro.login | ✔️ |