wx.checkSession¶
- wx.checkSession({[success][, fail][, complete]})¶
检查登录态是否过期。
通过
wx.login()
接口获得的用户登录态拥有一定的时效性。 用户越久未使用小程序,用户登录态越有可能失效。 反之如果用户一直在使用小程序,则用户登录态一直保持有效。具体时效逻辑由微信维护,对开发者透明。 开发者只需要调用wx.checkSession()
接口检测当前用户登录态是否有效。登录态过期后开发者可以再调用
wx.login()
获取新的用户登录态。调用成功说明当前 session_key 未过期,调用失败说明 session_key 已过期。更多使用方法详见 小程序登录。- 参数
success (
function()
) – 接口调用成功的回调函数fail (
function()
) – 接口调用失败的回调函数complete (
function()
) – 接口调用结束的回调函数(调用成功、失败都会执行)
- 示例
wx.checkSession({ success() { // session_key 未过期,并且在本生命周期一直有效 }, fail() { // session_key 已经失效,需要重新执行登录流程 wx.login() // 重新登录 } })